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NEXT 
MONTH 


LEARN TO LOVE YOUR 
PRINTER 


Part 2 of Bryan Davies’ introduction to 
printer control. 


QUILL IN ASPIC 


Taking your Quill output to the 
typesetter. 


New Q—Liberator 


Liberation Software have re- 
leased Q Liberator 3,3, an- 
nouncing the new version of 
the SuperBasic compiler as 
fully Minerva-compatible and 
bundled with Qload and QRef 
for the inclusive price of £50. 
Q-Liberator is now described 
as fully compatible with all 
versions of the Minerva rom, 
and supporting all the 
SuperBasic enhancements 
within Minerva. It allows com- 
pilation of programs using the 
dual screen mode, and also 
works with multiple Basic in- 


The All Formats Computer Fair 
comes to the Birmingham area 
this month. The first regional 
All Formats fair is set to appear 
at the National Motorcycle 
Museum, Coventry Road, So- 
lihull on Sunday 21 April. The 
fair will be run as usual from 
10am to 4pm. 

The National Motorcycle 
Museum is a well-known local 
venueandis conveniently sited 
just the other side of the Cov- 
entry Road (Solihull bypass) 
from the vast National Exhibi- 
tion Centre complex, just off 
junction 6 of the M42. The site 
is several miles outside Soli- 
hull town centre and further 
still from central Birmingham, 
so rail (and air) travellers 
should go to Birmingham In- 
ternational (NEC); road users 
should follow signs to the NEC 
until they locate the tiled roofs 
of the Motorcycle museum on 
the other side of one of the 
mainaccess roundabouts to the 
NEC, The Motorcycle Museum 
has its own car park. 

Entrance as usual is £3 on the 
door or in advance from Mike 
Hayes, 8 Midgrove, Delph, 
Oldham OL3 5EJ (cheques 
payable to JRMH) or John 
Riding 0225 868100, Stands 
from £75. 
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terpreters, making full use of 
the Minerva rom’s fast arith- 
metic and graphics routines. 
Integer tokenisation is fully 
supported, and allows 
Q Liberator to produced faster 
and more efficient code. 
“Keeping up with the rapid 
evolution of Minerva wasn’t 
easy, but we have worked 
closely with QView to ensure 
that our users have no compat- 
ibility problems,” says Q_Lib 
co-designer Ian Stuart, 
Amajorenhancement in V3,3 
is compiler support for the 


Swan Disk Packs of Corby are 
in their tenth year of postal 
pack production, and would 
like us to know that they are 
now producing 

amini-disk pack for 1991. A 
rigid construction offers ideal 
protection, and the unique de- 
sign ensures easy assembly in 
seconds: now available in three 


WHEN ERRor and WHEN 
VARIABLE constructs. A JS or 
later OL rom is needed to com- 
pile programs using WHEN, 
but Q_Lib will produce com- 
piled programs which will run 
correctly on any QL. Other fea- 
tures include improved error 
reporting, and the ability to call 
procedures which run as 
standalone jobs. Default direc- 
toriesand compiler options can 
now be customised with the 
standard QJump config pro- 
gram. Q Liberator is specifi- 
cally capable of compiling pro- 
grams which use the Tony 
Tebby pointer environment. 
Other Liberation software 
includes QLoad, which sig- 


standard sizes, 6 by 6 in, 8.75 
by 8.75 in and Mini Disk. Mini 
disk is of little assistance to OL 
users, but disk owners might 
like reminding that cardboard 
postal packs will keep. your 
disks crisp and flat, your disk 
envelopes: crumple-free and 
smartly creased along. the 
edges, as befits.a true product 


nificantly reduces SuperBasic 
loading times, and Resident 
Program Manager, which sim- 
plifies the placing of program 
code into rom. Both are also 
Minerva-compatible. 

QLib 3,3 costs £50. The up- 
grade price for 3,2 users to re- 
turn their masters is £10, and 
for earlier (non-budget) ver- 
sions £15, including a complete 
new manual. Budget Q-Lib 
owners can upgrade to the full 
specification compiler for £30. 


Enquiries and orders to Lib- 
eration Software, 43 Clifton 
Road, Kingston upon Thames, 
Surrey KT2 6PJ. Tel. 081 546 
7795. 


of Corby. They represent a 
major advance on stapling 
disks to the covering letter. 
From good computer suppli- 
ers and stationers everywhere. 
Bulk enquiries to Swan Pack- 
aging Ltd,, Unit 6, Princewood 
Rd., Earlestree Industrial Es- 
tate, Corby, Northants NN17 
2AP 


(PEN WHANNEL 


Open Channel is where you have the 
opportunity to voice your opinions in 
Sinclair QL World. Whether you want to ask 
for help with a technical problem, provide 


Hmmm. . . What's this? A 
Miracle Systems 68020 proto- 
type board? Tell me more! 
Please! 

By the way, take as read all 
the usual compliments about 
the magazine. Itreally isa boon 
to us QL addicts out there. 

Andrew Towler 
Nottingham 


Editor’scomment: We'll tell you. 
. as soon as we know. Miracle, 
bless ‘em, play their cards close to 
their chest. Better than loosing off 
prematurely—that's probably why 
they're still here after all these 
years. 


Some years ago I purchased a 
Sandy Superdisk V1.00 16AG, 
1984, with a single disk drive. 
This I found most reliable, but 
I now wish to add a second 
disk to use Perfection Plus. As I 
have limited finances, could 
you please advise me if a dual 
drive would plug into my ex- 
isting memory expansion and 
if the size of that memory is 
adequate to cope with such a 
new program. 
DO Topp 
Scaynes Hill 
Sussex 


Editor’s comment: once again 
this is the kind of question best 


somebody with the answer, or just sound off 
about something which bothers you, write 
to: Open Channel, Sinclair OL World, 
116/120 Goswell Road, London EC1V 7QD. 


answered by someone who is cur- 
rently using the Sandy drive for 
the type of purpose Mr. Topp en- 
visages, and we would be pleased 
to hear from anyone with the an- 
swer. Has he followed our usual 
advice and had a word with DP 
first? Software publishers cannot 
always answer this kind of spe- 
cialised, hardware-related 
question but they are a good place 
to start. 


Isthereanyone who could help 
me? I bought my JM QL in 
1985 and have been using it 
continually ever since. When I 
bought my QL it came with 
V2.0 of the Psion suite and an- 
other cartridge titled The 
Games Cartridge. On it were 
several games (Zfred, Pirate, 
Breakout, Gun and Treasure). 
The latter is a SuperBasic ad- 
venture by Halvor Heuch, 
Unfortunately I have never 
been able to get it working, 


because the microcassette was’ 


corrupt from the time I got it. 
This only affected Treasure, 
and noamount of hacking into 
the cartridge with Talent Car- 
tridge Doctor or hex/ Ascii 


dumping to the printer has 


found the lost sectors. 

Is there anybody who has a 
working copy of Treasure who 
would be kind enough to ei- 
ther give me a copy of the 
listing, ora copy onmicrodrive 
or 3.25in disk (either return- 
able), to save me from the 
frustration of having an almost 
working copy of what looks 
like a good text adventure? 

Terry McKnight 
Salford 
Manchester 


This letter is an idea for DIY 
Toolkit section which will en- 


hance the QL graphics. In 256 x 
256 resolution mode§, it is pos- 
sible to have a full eight colour 
palette, but in 512 x 256 mode4 
it is only possible to have four 
colours. I was wondering if it 
would be possible to have a 
command such as MODE16, 
which would enablea full eight 
colour palette, but I should 
think this would take up 64K 
of memory. However, most 
people have a memory expan- 
sion of some sort and, if not, for 
any programs needing a full 
128K, the mode could be 
switched back to four or eight. 
If this is not possible, then a 
follow up on the LINE and 
PLOT commands featured in 
DIY Toolkit would be useful. 
This could includea ‘circle’ and 
‘arc’ command, which works 
with the pixel co-ordinate sys- 
temas well. Alsoa full function 
which works with these com- 
mands as the present full 
command does not. 
Simon Walker 
Evesham 
Worcs 


Reading QL World March 1991 
I saw Edward Jones’ request 
for the address of Rodime Plc. 
Rodime’s phone number is 
0592 774704, asking for the 
technical department. I used 
this number myself about a 
year ago, so they should still be 
there. (They are, and the address 
is Rodime Europe Plc, Nasmyth 
Road, South Field Industrial Es- 
tate, Glenrothes KY6 2SD.) 

A useful tip for readers who 
have difficulty obtaining phone 
numbers is to contact the vari- 
ous customer service offices by 
phone at major post offices. I 
have tried this method when 
BT’s directory enquiries can- 
not help. 

DJ Brown 
Whitmore Park 
Coventry 
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Thanks 


This letter is nota letter of com- 
plaint, although it may sound 
like one in parts, but is instead 
one of the thanks to everyone 
concerned, for helping my QL 
get onto its little plastic feet 
again, and finding the solution 
to a rare, if not unique, prob- 
lem. 

I recently bought the latest 
Trump Card 768K package 
from Miracle Systems, partly 
due to the microdrive cartridge 
supply problems and partly 
due toa bit of good luckinvolv- 
ing football! I had read good 
reviews of the interface, and 
was in any case becoming an- 
noyed that every Quill 
document was limited to about 
1100 words before mdv2_ be- 
gan to operate almost 
constantly. 

Imagine, then, my dismay 
upon plugging the Trump Card 
into my D15 JS rom QL, con- 

necting the power and being 
_ presented witha totally locked- 
up machine, with no sign of a 
memory test and certainly no 
“F1,..F2...” starting screen. As 
T have had over four years of 


: reliable, unexpanded comput- 


ing, eventually with just about 
every port except the main ex- 
pansion socket connected, I 
suspected a fault had occurred 
onthe interface and sentit back 


to Miracle for attention. 


They were very quick in re- 
_ turning the board to me witha 
~ note stating that it was in per- 
fect working orderand the fault 
must be in my computer. They 
recommended that I contact TF 
Services about the problem, and 
- said that if a solution was not 
found thena full refund would 
_ be given. 
Tony Firshman of TF Serv- 
ices suggested that I try other 
power supply units and inter- 
- faces with my QL before 
sending it to him. He also sug- 
gested that I remove the 
Q-Power regulator which I had 
fitted in September 1988. His 
reason for this was that the ear- 
lier version has been know to 
give rise to Bad or Changed 
_ Medium messages, especially 
_ from mdv2. 


as I followed this advice and 


with the help of Mr. Arthur 

_ Nunn, one of two users I know 
inthis area,I tested my psu, QL 
and Trump Card with his ma- 
chines. This revealed that the 
fault did indeed lie in my trusty 
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QL, so off it went to TF for 
repair. 

Within a week, it was back 
with me in a fully cured and 
expandable state. The problem 
had nothing to do with the edge 
connector, a dry solder joint or 
cut peb track, but instead with 
the 68008 cpu. The remedy was 
to swap the original chip for 
one with gold plated pins to 
give better connections. As well 
as this, the microdrive units 
were swapped over, which 
stopped #2 playing up occa- 
sionally. The repairs are 
covered by a six-month guar- 
antee and the bill came to £25. 
With service like that Ihope TF 
Services is busy for many years 
to come. 

Ian Thompson 
Ripon 
N. Yorks 


Underline 


When using some microdrives 
with Quill, I find that the 
command load, device? mdv2- 
‘results in a screen list which 
has each entry underlined. 
When this occurs, loaded 
documents also appear on the 
screen with all the text under- 
lined: any fresh material 
inserted in the document is 
similarly underlined, and a 
new document added to the 
mdvy is underlined on the 
screen in the same fashion. 

Fortunately, when printed 
out, the text is normal, but 
working with the screen text 
underlined is not easy on the 
eyes. Crashing the QL, reload- 
ing Quill, and commanding a 
named document or creating a 
new one (without invoking the 
‘Load, device? mdv—’ proce- 
dure), cures the screen 
problem. 

Have others experienced this 
phenomenon, and can anyone 
explain it? 

Beryl Crawley 
Welwyn Garden City 
Herts 


More C 


May Isay how satisfying itis to 
see that QL World acknowl- 
edges the existence of the C 
programming language. 


If I could be allowed a few. 


suggestions I think Mr. Wright 
would acknowledge that his 


articles, good as they are, can- 
not really be anything but a 
way of interesting people in 
this magnificent language, and 
that thereis nothing likea good 
textbook to actually teach it. 
Incidentally, I can thoroughly 
recommended The C Program- 
ming Tutor by Westman and 
Sidebottom, published by 
Prentice/Hall International. 
Even I can understand it, and 
it’s cheaper than most. 

My suggestions for subse- 
quent articles would be: 

(a) helping self-taught pro- 
grammers like myself to write 
better, or more concise and 
subtle, code—something along 
the lines of DIY Toolkit, or Su- 
per Basic. 

(B) to take one or two read- 
ers’ queries each month and 
answer and develop them. 
When you are a self-taught 
amateur, there are dozens of 
questions and queries that in- 
evitably go unanswered, 
however many textbooks you 
may read. 

GF Fisher 
Knowle 
Bristol 


Small C 


My letter in Open Channel in 
February 1991 must have been 
quite old, as I have become a 
second year student going for 
industrial placement. I like the 
Programming in Cseries. As you 
may know, the Digital Preci- 
sion C-compilers, of which I 
bought a Special Edition one 
many years ago, are in fact 
small-C compilers. 

Small-C is a subset of C as 
specified by Kernighan and 
Ritchie, and doesn’t provide 
things like multi-dimensional 
arrays, structures or floating 
point expression parsing. Al- 
though these features are not 
necessary for small applica- 
tions, writing larger programs 
which use graphics or attempt 
to set up databases is almost 
impossible without these fea- 
tures. 

My question is — will Digital 
Precision develop the existing 
small_C compilers to provide 
a full-blown K&R implemen- 
tation of the C language? This 
should not be difficult, since 
the author of digital C obvi- 
ously has shown his excellent 
abilities in compiler writing, 
and the Digital C compilers 
were written in ‘compiled 
small-C’. 


I reckon that when a full im- 
plementation of C is made 
available for the OL, programs 
written in C on other machines 
will instantly compile for the 
QL, making tonnes of new pro- 
grams available. Also, more 
authors will be attracted to the 
QL. 

My correspondence address 
was slightly wrong in Febru- 
ary. Itis 45 Marlborough Close, 
Grays, Essex, and my email 


address is 
cs89ssg@uk.ac.brunel.cct. 

Sunil Gupta 

Grays 

Essex 


Editor's comment: yes, your let- 
ter was one of a batch that was 
overlooked when we moved the 
magazine away from Greencoat 
House. When they turned up I 
decided to run most of them with 
small changes, and hope the au- 
thors had followed our progress. 
Clearly they have. 


Freddie Vachha of Digital Pre- 
cision writes: The key words 
are ‘many years ago’. As we 
announced in our ads over a 
year ago, we’ve added many 
of the features he stated were 
desirable. The current version 
of Digital C Special Edition 
does support structures and 
floating point - an upgrade 
from the earlier versions costs 
£10 (return the original disk to 
us). Our implementation is 
now far in excess of the Small- 
C standard, and is not that 
distant from the full K&R 
standard; indeed, most of the 
small number of K&R features 
that Digital C lacks are either 
insignificant, or undesirable in 
terms of good programming 
practice, or both! Digital C 
Special Edition is very, very 
fast, and ‘self-compiled’ (proof 
of great flexibility). 

The point about multi-di- 
mensional arraysisanexample 
of an insignificant feature: to 
use an analogy with SuperBa- 
sic, DIM A (m,n) is equivalent 
to DIM B(K) where k=m*n. 
There are one-to-one corre- 
spondences between the 
elements of the two-dimen- 
sional array A and those of the 
single-dimensional B; one ex- 
ample is given’ by 
A(x y)=B(n*x-1)+y). The logic 
can be extended toany number 
of dimensions. 

One last point; many people 
confuse the K&R standard with 
Lattice C. We can’t doa Lattice 
C compiler, because the Lat- 
tice C is copyright material. 
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ome letters we get cannot be dealt 

with in a couple of lines here. 

There was the nearly -8,000 words 

letter from Gerard Phelan, and 
now there are 19 pages (I’m not counting 
the words) from Orjan Larsson, of 
Karlskoga in Sweden. This month, I'll try 
to comment on some of the points raised 
by them. 

Phelan was prompted to write by com- 
ments made in QL Worldaboutthe Minerva 
Qdos-replacement rom from QView. He 
felt that our comments were something of 
asmear. Infact, regular contributors to QL 
World do take notice of input from readers 
(and others on the QL scene); it makes 
sense to do so, since we are paid to keep 
people interested in the QL. Had we not 
(separately) received letters and calls of 
complaint, we would nothave commented 
on Minerva. The letters detailing software 
problems that have arisen after Qdos roms 
were replaced by Minerva ones continue 
to come in. Maybe the publicity will focus 
sufficient attention on the problems that 
have been created to get most of them 
sorted out. 


Miracle 


There were several other subjects in 
Phelan’s letter. One was the Miracle hard 
disk, and its commands. Seeing bulletin 
board notes from several users, | initially 
hoped that there might be something there 
that would guide me in setting up the 
friend's hard disk which has lain on my 
workbench for several months, but that 
hope was soon dashed. Perhaps a recap 
of my problem here will bring comment 
from users who are familiar with the MS- 
DOS sub-directory structure. Users who 
know only Qdos are unlikely to appreciate 
the problem, as they will not have been 
much interested in the subject; itis a thing 
which comes up when you have mass- 
storage devices, such as hard disk. 

Put simply, what | would like to do is set 
up a sub-directory structure on the QL 
hard disk which is essentially similar to 
that on the PC/AT. There is nothing magi- 
cal, or exclusive, to the MS-DOS 
directories. You start at the top (or bottom, 
if you think in terms of a tree) with the root 
directory. This is where every saved file 
will go if no instruction is given to send it 
anywhere else. Your QL disk and car- 
tridge files are normally stored in the root 
directory of the particular medium that 
was in the drive when the save command 
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Bryan Davies 
sorts out the long 
letters from the 
short ones 


was issued. 

As you get more files, in more catego- 
ries, you begin to realise that you cannot 
keep track of them; files cannot always be 
related to a particular program or data 
subject by examining the file names. For 
example, it is fairly easy to recognise 
program files that are connected with The 
Editor — Edt_bin, Edt_charset, Edt_hlp 
have an obvious character-string in com- 
mon. 

But what about the data files associated 
with the same program? Do you put an 
extension on all of them (since the pro- 
gram does not)? If yes, do you use _ TXT, 
for instance? That would be a way of 
identifying data files created with this pro- 
gram, although it might not be the best 
choice since _TXT is an obvious exten- 
sion for Ascii files in general —thatis, ones 
that are pure-text, and might be created 
by an Export command from various pro- 
grams. No great problem so far, but what 
if (like me) you use text®* FlashBack, 
Perfection, Q_Switch, The Editor, Aba- 
cus, Files Ii, Professional Publisher, 
Archive, etc, etc? What if you have a 
hundred disks, each containing from a 
handful to over a hundred files? 

At this level of activity, you have difficulty 
knowing what files are connected with. 
Laborious manual record-keeping (and 
‘manual’ includes typing details into a QL 
program) doesn’t work for long; you find 
yourself getting fed up with the constant 
additions and revisions required. If you 
aren'tconvinced, think how many files the 
40 MB Miracle hard disk can hold. More 
than a thousand files is a lotto identify. So, 
you need to split the files into groups, and 
put them under different, recognisable 
headings. It may be sufficient to put all 
files connected with one program into the 
same directory, but some users may feel 
the need to keep the program files, and 
data files created with that program, sepa- 
rate. The latter course means two 
directories instead of one, for instance, a 
directory named EDITOR for the program 


files and one named EDITOR_TXT for the 
data files. The second one would be a 
sub-directory of the first. Bear with me if 
you know how to set up such sub-directo- 
ries on the Miracle hard disk —so do |, but 
that’s not the problem. 

Users who habitually run more than one 
program, and who invest in a hard disk, 
may want to have similar pairs of directo- 
ries for each major program, and perhaps 
another for a category such as utility pro- 
grams. They could easily end up with, | 
say, four sub-directories beneath those 
sub-directories, for data files. A mecha- 
nism is then needed to enable both the 
programs and the user to know just where 
they/he/she are at any given moment, and 
to be able to access each sub-directory 
quickly, from any other sub-directory. 

This is where my problem arose. Al- 
though the mechanism for setting up 
sub-directories seemed a bit strange to 
me, | set up several levels of sub-directory 
for various programs, and copied files to 
them, but | couldn't find a sensible way of 
accessing them all. 


The catch 


To enable a program to operate cor- 
rectly, and find files which are not in the 
same directory as the program files, there 
is acommand provided with the hard disk. 
This works fine, for the one program. 
What happened to me was that, when a 
second program was started, the two pro- 
grams appeared unable to use their ‘own’ 
sub-directories, and likewise when any 
other programs were started. They all 
appear to end up using the same sub- 
directory, unless a change-directory 
commandis typed-in atthe keyboard every 
time you switch from one program to an- 
other. What happens when programs are 
actually running simultaneously, | don't 
know. 

On a different level, when the user is 
utilising SuperBasic to do housekeeping 
tasks, there is no indication on the screen 
of which directory he/she is currently 
working in, and no straightforward way of 
getting into any other sub-directory. Maybe 
I've been spoilt by having a good utility 
program that displays all the sub-directo- 
ries, and the files in them, and highlights 
the place the user is working in. Naviga- 
tion from one sub-directory to another 
with that utility requires use of no more 
than the Enter and cursor keys. Even MS- 
DOS, with all its faults, provides a 
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command to cause the cursor display (the 
‘prompt’) to be accompanied by the full 
name of the current sub-directory, and 
another to enable the user to change from 
one sub-directory to another, without af- 
fecting any programs which are loaded. 


Structure 


First question: can the directory struc- 
ture with QL hard disks reproduce all the 
features of the PC/MS-DOS structure? 
Second: is there an easy way of knowing 
where you are in the structure at any given 
time, and of moving to any other place? 
Third: can several programs be multi- 
tasked from sub-directories (with their data 
files in other sub-directories) and switched 
between without the necessity to type in 
commands to alter the default sub-direc- 
tories? (I might add, on this last one, that 
itisn't satisfactory to me not to know which 
program you are going to get when you hit 
a particular Key combination — that is, 
repeated keying of CTRL-C or such unti! 
you ‘find’ the program you want.) 

My correspondent from Sweden is clearly 
a serious hacker. He is several years out 
| of date in thinking | am Ron Massey (I 
don't think Ron would be too flattered by 
that!), and he seems to have a consider- 
able collection of museum pieces. 
However, he also has some modern ma- 
chinery, and obviously takes a keen 
interest in the micro scene in general. Like 
most of us, he can't afford to buy some of 
the computers which take his fancy. The 
list of what he has (or has had) includes 
ZX81, home-built Z80-type, Spectrum, 
C64, Z88, Mac-Plus, and QL. What he 
has, and what he would like, got a bit 
confused in translation (to English) but 
Amiga 500, Atari ST, IBM PC, (QL) Futura, 
Amiga A3000, PC3000 (?}, Amstrad PCW, 
IBM PS/1, PS/2, and several others, were 
mentioned in the letter. 


Ideas 


Quite a few readers will undoubtedly 
have little idea of what some of those 
mode! designations stand for, and | won't 
bore them further with details. They're not 
QLs, for sure. What Larsson wanted to do 
was express some of his ideas for a QL- 
replacement. 

There has been a trend on the part of QL 
hackers in the direction of the PC, froma 
hardware point of view, and Larsson goes 
along with this. A PC-type keyboard, for 
instance. Incidentally, the ‘PS/2-type’ la- 
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bel that seems to be popular in the QL 
world is presumably incorrect, and whatis 
meant is either PC/XT-type or AT-type, 
the latter being the usual type supplied 
with current PCs. The PS/2 is from IBM, 
and the keyboards users are putting on 
their QLs are generally not from that 
source. 

He also favours a box that doesn't look 
like a PC, but needs to be bigger than a 
QZL. As he says, one good selling point 
for the Macintosh is that it is obviously not 
aPC. Youdo need abox with space, to get 
floppy and hard disk drives in (maybe we 
should include cd-rom and other newer 
devices now?), afan (almost inevitable), a 
large power supply, and interfaces for 
disks, printers, display, etc. 

The tower (standing on end) configura- 
tion has appeal, but | suspect that is 
mostly from a marketing aspect and there 
is little practical merit in it. The argument 
that the tower takes up less space than 
the conventional flat box is rhubarb; if 
anything, a tower box has alarger volume 
(for reasons of strength) than an equiva- 
lent conventional PC, and most users 
would scarcely find it convenient to park 
the computer under a desk. 


Same space 


If a user fancies it, many non-tower 
boxes can be stood on end, but you still 
have to put the display on something — 
does it magically take less space when 
not on top of a computer box? Few com- 
puters now use the QL approach of putting 
the electronics and the drives with the 
keyboard, mainly because both electron- 
ics and drives on most current computers 
are far larger than the equivalent items in 
the QL. Miniaturisation has not gone any- 
where near far enough for two or three 
drive units to fit in a QL-size casing, let 
alone all the electronics. The snag with 
the alternative approach of putting drives 
and electronics in the display unit is that 
this prevents any choice of display. 

The display type can soon take the com- 
plete system way beyond the range of 
most of us. Larsson fancies an A4-size 
display, because it is good for dtp work, 
but my feeling is that serious dtp work 
requires pages to be displayed side by 
side, and that means something like A3 size. 
The only screen of that size | have used (it’s 
great!) cost around £2,000, and that may be 
abouttwice whatthe ordinary individual buyer 
would pay for a complete system. 


OTER 


Moving back onto the desk/bench, he 
thinks ‘a combination of mouse and nu- 
meric keypad (hamster) is not good’. Can 
you visualise a hamster alongside your 
keyboard? One thing is certain, and thatis 
that the mouse must be an integral part of 
the computer, in both hardware and soft- 
ware terms, so that programmers simply 
have to access built-in mouse routines, 
rather than write their own. 


Trackerball 


The trackerball (almost an inverted 
mouse) has the merit of being suitable for 
incorporation into the keyboard, and at 
least one portable now has a slide-and- 
roll device installed in the middle-front of 
the keyboard. Whether or not such a de- 
vice could replace the mouse for use with 
graphics programs is very debatable, but 
| doubt it at the present state of develop- 
ment. 

There is no significant desire for disk 
units which can read/write in several for- 
mats, to enable data to be transferred on 
disk between different types of computer 
simply. Because of the enormous number 
of 5'/sin and 3"/zin disks already in use, 
there is little commercial sense in specify- 
ing any other disk size. The 37/zin size is 
gradually ousting the 5'/sin, so it seems 
the obvious choice. Capacity is not so 
obvious; we already have 720 KB, 1.44 
KB, and odd figures like 800 KB, and 
drives/disks giving 2.88, 4 and even 20 
MB per disk are said to be ready for 
commercial use. The chances of the re- 
ally-high capacity drives being able to 
both read from and write to current dsdd 
disks don't appear too good. 

Leaving Larsson's letter for the moment, 
what about money? Does a QL-replace- 
ment need — by definition — to be cheap? 
And what is cheap to us? The usual logic 
of mass production has brought the 
standard IBM-type PC clone down to a 
cost which seems laughable when com- 
pared to many other, familiar items. How 
do you rate a PC system against a few 
weeks’ supermarket shopping? Or petrol 
for a month or two? There are many basic 
systems being sold now for £200-300. But 
you don’t get a fast 16-bit processor chip, 
colour display, and 40 MB hard disk at that 
price. For £1,000 you can get 16-bit op- 
eration and hard disk, but not a decent 
colour display. Any computer that will be 
able to run existing QL programs will not 
sell in large-enough quantities to be able 


to get near this kind of price if equivalent 
features are provided. Maybe it is possible 
to get the features many of us would want 
for around £1,500, but don’t hope for a 
good system for much less than this. Bear 
in mind that the display and drives are 
expensive items, accounting for maybe half 
the system cost. 


Core 


Returning to the letter, the operating sys- 
tem is at the core of the computer. It can 
| make or break the computer. Larsson 
doesn’t fancy the command line interface 
for the user. That is, anything that requires 
the user to type-in commands at the key- 
board, as is the case with SuperBasic. The 
Mac popularised the graphic type of inter- 
face, utilising a mouse, and the current 
Windows program provides a similar thing 
on PCs. 

QRam/QPac offer something along the 
same lines for the QL, although they seem 
to be biased towards the hacker type of 
user rather than ordinary types, and would 
be too complicated (and pedantic) for a 
mass-sale system. Although the old Ice 
set-up from Eidersoft is subject to some 

| derision nowadays, it had several of the 
essential features for an easy-to-use inter- 
face, suitable for non-technical users. 

So much for speculation. When you get 
down to what is real, the answer is — as 
always — Miracle Systems. Their add-on 
accelerator board for the QL may already 
be available when this issue reaches the 
news stands. Hopefully, it will be a ‘half- 
way house’ development, rather than a 

| giant step. That is, something with a 68000 
processor or, maybe, a 68020, not a 68030 
or 68040 (there are later versions than 
these, but not in marketable computers, so 
far as | Know). A jump to 16-bit operation, 
and 1 MB or more of memory, will be 
enough to satisfy many QL users, and the 
main point may be price rather than speed. 
The letters we receive make it clear that QL 
users are often not flush with money; it is 
not unusual to read that one of our readers 
is saving pension payments to be able to 
buy, say, a disk interface. 


Printer prices 


It may seem irrelevant to the QL scene to 
talk about laser printers, as | often do now, 
but prices continue to tumble. The dmp 
printer one bought when the QL was new 
has very likely gone down in price about 
50% since that time, and several laser 
printer models have gone down that much 
in less than two years. Software®’ say that 
they are a bit surprised at the orders for 
their DeskJet printer driver and, if people 
can afford that printer, they can afford a 
laser. 

The driver | have commented on previ- 
ously, for the Epson GQ-5000 laser printer, 
costs £40; for this price, two drivers are 
supplied on the disk, and users of both the 
GQ-3500 (the earlier model) and the EPL 
7100 (the latest one) can use either of 
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these. The main difference between the 
two is that the 3500 driver does not access 
the Prestige fount, or the scaleable Times 
and Helvetica, but it does provide double- 
and treble sizeforms of the basic 3500 
founts, as a partial substitute for the 6-72 
points sizes available with the 5000 driver. 


Pro Pub 


An odd point to note for Kaga-Taxan 
users who have bought a laser printer is 
that it is preferable to use the FX-80 driver 
of text®’ rather than the Canon one, when 
printing on the laser in its FX-80 emulation 
mode. Some errors in alignment apparent 
in the samples included with a recent arti- 
cle appear to have been due to using the 
Canon driver, which has some functions 
which are not standard to the FX-80. The 
sample given here was done with the GQ- 
5000 laser driver, to show how well 
proportional spacing and justification is 
handled. 

Asignificantimprovementhas been made 
to Digital Precision’s Professional Pub- 
lisher, reducing the loading speed by about 
two-thirds; the speed of other input/output 
operations is similarly improved. The 
ProPub Tools utility includes founts which 
are better than those with the basic pro- 
gram. 


Dispute 


There is something of a dispute being 
carried on within the pages of the Quanta 
newsletter, concerning the capability and 
ease of use of Professional Publisher. It 
was sparked off, to some extent, by my 
comments in an article on ProPub last 
year. | said that producing reasonable 
pages with that program was a distinctly 
lengthy exercise, for me. Some readers 
may not have fully considered what was 
said, because the main points made — 
apart from the obvious fact that serious dtp 
work requires lots of time, regardless — 
were that | was (and am) a novice as far as 
that program is concerned, and that the 
time spent using other programs to pro- 
duce text and graphics input for ProPub 
was (is) a major part of the total time 
involved. The raised hackles of certain 
correspondents (plus a well-known sup- 
plier!), and my own present interest, 
combine to suggest more attention be paid 
to the subject of dtp, so expect more 
comment on this subject in future articles. 

The Portuguese supplier Ofile sent in 
version 2 of Discopy, and we hope to print 
a mini-review of this updated version be- 
fore too long. The program now comes with 
a nice, printed instruction booklet. The 
address for orders is the same as before — 
Ofile, Apartado 2110, P-1103 Lisboa 
Codex, Portugal. The author of the program 
(and of MS-QLink) obviously has a busy 
life, earning his living during the day and 
finding a few hours at night for his QL. He 
comments that text®’ corrects his spelling, 
but doesn't improve his sentences! That’s 
a really heavyweight subject for any pro- 


grammer to get his teeth into, and the QL 
market wouldn't reward any efforts in this 
direction very well. Maybe we could ask for 
asmaller step, such as making a spelling 
checker capable of spotting errors such as 
double use (‘the the’), incorrect forms of 
words (‘too’ where ‘to’ is required), sen- 
tences started with small letters, and so 
on? 


Readers’ Letters 


Digital Precision report not finding any- 
thing wrong with a Professional Astrologer 
disk returned to them by D.S. Graham, but 
they sent a replacement last August. As 
Graham wrote since then to say he was 
still waiting fora replacement, another one 
has been sent (February). Michael 
Cronsten should by now have received a | 
Miracle hard disk from TK Computer- 
ware, to replace the one that apparently 
went astray. The replacement was sent 
before Christmas. There was some delay 
whilst the Post Office processed the claim 
for loss of the original unit. TK comment that 
Mike Jackman’s problem using Technikit 
is (so far as they are aware) related to 
using the program on a Thor (model un- 
specified), for which the program was not 
written. Attempts by them to contact Thor 
International for information on Thors have 
failed (has anyone managed to get a re- | 
sponse from Thor International in the past 
year?). Frequency Precision have sent 
the batteries ordered by J R Goodall; as 
the latter regularly has problems with items 
despatched to him in Belize, it is not sur- 
prising to hear that his original order letter 
was not received, and the order was des- 
patched only when a chase-up letter 
arrived. 

Frequency Precision sold a fair number 
of their battery-backed power supplies for 
the QL, and these seem to have been 
effective.in dealing with lockups caused by 
poor mains supplies. As this supplier is not 
now selling this unit, it has been suggested 
that construction details may be given to 
QL World readers in the form of an article, 
so that DIY readers can build their own 
power supplies. Watch for an article on this 
in a future issue. 

We are all anxious to receive the new 
piece of software we've just ordered, but 
some buyers’ enthusiasm seems to over- 
come them. One supplier reports receiving 
a chase-up call from a customer on the 
same day the cheque for the goods was 
sent! Another customer chased delivery of 
goods, ordered by credit card, within four 
days of placing the order, apparently una- 
ware of the fact that authorisation for credit 
card purchases is not automatically given 
straight away; in this case, five requests 
were made (over several days) before 
authorisation was given by the card com- 
pany. The obvious explanations appear to 
be either that the customer had not paid a 
previous account off and was above his 
credit limit, or that the card company’s 
computer system was having an off day (or 
two). 
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More information 
from the 


Pure QL Show 


The National Dutch QL Users 
club, Sin_QL_air now have a 
list of addresses and prices for 
hotels and boarding houses 
near the site of the Pure QL 
Continental Microfair, first an- 
nounced in QL World March 
1991. As we writein mid-April, 
Sin_QL_air is requesting clubs 
and suppliers toattend the Fair 
with demonstrations, and is 
expecting to demonstrate 
progress on its own Sigma- 
QL68008FN10 4 megabyte OL 
project. 


Further information about 
the Fair can be accessed on the 
Club bulletin boards (Nether- 
lands) 035 216520, 300/1200/ 
2400, 1200/75-T, 24 hours, and 


Essex 
workshop 
cancelled 


Itis with regret that we have to 
report the death of Bob Gingell, 
active Quanta member and or- 
ganiser of the Essex Workshop 

| on 18 May reported in last 
month’s OL World. This event 
has been cancelled, Quanta 
members particularly will ap- 
preciate Bob's work organis- 
ing events and will miss him 
greatly. 

Colleague Ron Dunnett con- 
tacted QL World to say that he 
and Bob's son had tried to pick 
up the threads after Bob's 
death, but had been unable to 
do so to their satisfaction at the 
same time as coping with the 
family tragedy. 

Said Ron, "The Workshop 
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on the QLAT bbs, 030 962265 / 
2,283,508, 300/1200/2400, 
1200/75, 24 hours. 

The site and date of the Fair 
is St. Joriscollege, Roostenlaan 
296, Eindhoven, Netherlands, 
on 6 May 1991 from 10am to 
4pm. Contacts are J J van der 
Molengraaf, Mullerweg 17, 
5624 JC Eindhoven, Nether- 
lands, tel. (Netherlands) 31 40 
442309, English-speaking, for 
hotels, dates, local organisa- 
tion, or C M H Biemans, 
Elzenstraat 5,5461CL Veghel, 
Netherlands, tel. (Nether- 
lands) 31 4130 63224, in Ger- 
man, English and French, for 
club contacts and details of the 
user group and its publica- 
tions. 


was Bob's baby. He had put a 
lot of work into it, and it was 
the first thing on his mind 
when he went into hospital. 
His death was very sudden 
and unexpected." Itis expected 
that the Workshop will now 
take place in September. 


QL club in 
Norway 


A Sinclair club, NASA (Nor- 
wegian All Sinclair Associa- 
tion, and not to be confused 
with the well-known space 
agency of the same acronym) 
has been formed in Norway. 
The group publishes a Sinclair- 
orientated magazine called 
with great simplicity Sinclair 
Magazine, every two months, 
and also offers help to mem- 
bers with technical or software 
problems. 

Contact them via P Monstad, 
NASA, N-5580 Oelen, Norway. 


More than just a chair. . . 


The Multi-User 
Personal Resting 
System 


The latest in.» space-age per- 
sonal. comfort. devices.as fea- 
tured in our photograph is.the 
new Rexel Multi-user Personal 
Resting System.as supplied toa 
waiting. world by Action 
Computer Systems of Wem- 
bley, Middlesex. 

Within the System, models 
are available tailored to the 
needs of three classes of user: 
operators, programmers and 
managers. Despite the pro- 
gression from the lower forms 
of life to the higher, each and 
every module contains an ad- 
justable mounting, a support 
service, a rear support and two 
(2) side supports. 

Mountings, say Action, can 
be adjusted between a wide 
range of heights, allowing 
maximum flexibility in users' 
leg-lengths. The support sur- 
faces are made from moulded 
foam, and the rear supports 
contoured (it is not fully clear 
from the literature whether the 
‘rear supports’ are the horizonal 
or vertical non-open-space- 
filled surfaces, but both give 
the visual impression of 
conserable comfort). 

Thesystemsarenot themselves 
programmable but, Action ad- 
vise, this difficulty. can be over- 
come by programming users. 


For example, installation ofa 
simple ‘warning /dismissal' 
package will normally ensure 
that the majority of casual us- 
ers will avoid the resting sys- 
tem. known as the ‘manager's 
chair’. 

(Asimilar package, calling down 
the Curse of the MacSporrans 
upon casual users and other low 
life, has been in operation on a 
chair in this editorial office for a 
numtber of years, The QL: first in 
all things.) 

The Rexel Multi-User per- 
sonal Resting System conforms 
to a number of important Brit- 
ish Standards with reference 
to design and fire safety, and 


comes in red, blue or grey. The 


last laugh is definitely with 
Action and Rexel, as prices 
range from £153.90 for the 
‘operator's chair' to £262.80 for 
the ‘manager's chair’. 

Action Computer Supplies 
also sells, yes, computer sup- 
plies (leading brands), hard- 
ware and software, office auto- 
mation and datacomms equip- 
ment and other useful things 
at discounted prices to users 
through its 496-page free cata- 
logue, and can be contacted at 
Alperton House, Bridgewater 
Road, Wembley, Middlesex 
HAO 1EH. Tel. 0800 333 333. 


15 


ARCHIVE ANSWERS 


ne of the commonest things-to- 
do with a database containing 
numbers is to add them up. You 
can doit from Archive command 
line, with an instruction such as ‘let an- 
swer=0: all: let answer=answer+number: 
endall’. This gives you the total of all the 
‘numbers’ in your database, stored in the 
memory variable ‘answer’. Possibly the 
next commonest thing to do is average 
the total: ‘let average=answer/count()’. It 
starts to get cumbersome if you wish to 
look at several different fields from the file, 
and is no use at all if you want to deal with 
lots of sub-groups within the data file. 

The purpose of this Archive Answers is 
to simplify the process of sub-totalling and 
averaging of Archive data. We shall look 
first at the production of sub-totals — add- 
ing up all the entries for particular subsets 
of the data. The problem with sub-totals is 
that you can end up with quite a lot of 
them, to be stored or otherwise displayed. 
You could print them to paper, but then 
you can'tdo anything else with them. The 
ideal place for sub-totals is in another data 
file, where they can then be displayed, 
printed, or otherwise manipulated as needs 
dictate. 

The program does precisely this, with 
any database file you wish to use. It auto- 
matically generates a new file, with an 
identical field structure to the original, 
leaving the first file unaffected. Each nu- 
meric field is added up, and a new sub- 
total record is added for each different 
entry in the ‘key-field’. 

A little explanation about subsets and 
key-fields may not go amiss here. The 
assumption behind a subset is that the 
same subject is dealt with a number of 
times in the file. The key-field will be 
identical for each member of the subset, 
and the sub-total for any one subjectis the 
sum of all the values relating to it. 

For example, you may have a database 
of cricket scores. The players each have 
lots of entries — one for each innings they 
played. Each record could store, among 
other things, ‘name$’, ‘team$’, and ‘runs’. 
If the statistic you want is each player's 
total runs for the season, the key-field 
would be name$. There would be a sub- 
set of the records for which name$ is 
‘Gower,D’. By adding up all the runs in 
these records we can calculate the re- 
quired statistic. This process is repeated 
for all the players in the database. 

The same data can be used for a different 
statistic — the total runs scored by each 
team. In this case, instead of name$, you 
would make team$ the key-field. The sub- 
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totals would then be for all the records for 
which team$ was identical. 

The key-field must also be the field used 
to ORDER the file. If it is not, the various 
entries for each subject would be scat- 
tered around the file, making it very much 
harder to match them up. By ordering 
them, it is possible to step sequentially 
through the file, knowing that all the en- 
tries for each person (for example) are 
grouped together. 


Archive Answers 


Robin Sevenson continues his occasional 


column by simplifying two common functions: 


totalling and averageing 


Listing One - Totals and Averages. 


proc CopyStruc ;Oldfile$,Newfile$,Log$ 


local COUNT ,MAX 
let TEMPFILES=""TEMP_EXP" : REM Use RAM drive if available. 
use Oldfile$: let MAx=numf1d() 
print : print "Copying structure to "+Newfiles$; 
spoolon TEMPFILE$ export 
lprint “proc temp" 
lprint "create '"+Newfile$t+"’ logical ‘+Log$t rl 
let COUNT=0: while COUNT<MAX 
lprint fieldn( COUNT) 
let COUNT=COUNT+1L: endwhile 
lprint “endcreate" 
spooloff : merge TEMPFILE$:Temp 
use Oldfile$: print 


proc MakeList;Source$,Dest$,Opt ,KeyField$ 


local ¢ 
let C=0; while c<numfld() 
if fieldt(C)=0 and lower (fieldn(C) )<>KeyField$ 
lprint "let "sDestS;".";fieldn(C)7;"="i 
if opt=0: lprint Source$;".";fieldn(C): endif 
if opt=1 
lprint Source$;".";fieldn(C);"+";Dest$;"-";fieldn(C) 
endif 
if Opt=2: lprint Dest$;".";fieldn(C) ;"/SUBTOTAL": endif 
endif 
let C=C+1: endwhile 
lprint “update ‘";Dest$;"/" 
endproc 


proc Calc;Source$,Dest$,KeyField$,Av 


local COUNT,ANYS 
spoolon TEMPFILE$ export : lprint "proc Temp; Fst" 
lprint "IP ";Dest$;".";KeyField$;"=";Source$;".";KeyPield$; 
lprint “and Fst=0" 
MakeList;Source$ ,Dest$,1,KeyField$ 
lprint "else" 
if Av: lprint "if Fst=0:Avtemp: endif": endif 
lprint “append ‘";Dest$;"/" 
lprint "print: print "+KeyFieldg+";/ =’7: let SUBTOTAL=0" 
lprint "let ";Dest$;".";KeyField$;"=";Source$;".";KeyField$ 
MakeList;Source$,Dest$,0,KeyField$ 
lprint "endif": lprint "endproc" 
if Av: lprint “proc Avtemp" 
MakeList;Source$ ,Dest$,2,KeyField$ 
lprint "endproc" 
endif 
spooloff : merge TEMPFILES 
first Source$:temp;1: next Source$ 
while not eof(Source$) 
let SUBTOTAL=SUBTOTAL+1 
print num(SUBTOTAL,4);rept(chr(8),4)7 
temp;0: next Source$ 
endwhile 
let SUBTOTAL=SUBTOTAL+1 
if Av:Avtemp: endif 
print num(SUBTOTAL, 4) 
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The program printed in listing one is 
simple to use, because it automatically 
tailors itself to match the file in question. | 
Once you have entered the listing (as two 
separate procedures, using EDIT), and 
saved it (eg SAVE “TOTALS’) you can try 
it out, using the gazetteer database, 
GAZET_DBF. Unless you have moved it, 
this will be on MDV1_ (or FLP1_), along 
with the Archive program. It includes data 
on population, land area, etc. for a wide 


input "Press <enter> to continue. ..";ANY$ 


proc Total; Source$,Dest$,KeyField$ 


use Source$ 


CopyStruc;Source$,Dest$,"Total" 


print : 


print "Totaling "+Source$+" to "+Dest$; 


Calc:Source$, "Total", lower(KeyField$) ,0 


use "Total": first : 


endproc 


display 


proc Average; Source$,Dest$,KeyField$ 


use Source$ 


CopyStruc;Source$ ,Dest$, "Average" 


print : 


print "Averaging "+Source$+" to "+Dest$ 


Calc;Source$, "Average", lower(KeyField$),1 


use "Average": first : 


endproc 


range of countries, and you may wish to 
know these values for each continent 
covered. In this instarice, the continents 
are the subject, so ‘continent$’ is to be the 

| key-field. After opening the file, it must be 
ordered by continent, after which the ‘To- 
tal’ procedure is called. The steps to do 
this, entered at the command line, are as 
follows: 


LOOK “MDV1_GAZET” LOGICAL “GAZ” 
ORDER CONTINENT$;A 
TOTAL;"GAZ”,‘TOTCONT”,“CONTINENT$” 


The first two lines are standard Archive 
instructions. The third calls our new pro- 
cedure. Three extra parameters must be 
included when using Total. These are the 
‘logical file name’ of the source file to use, 
the actual file name of the new file to be 
created, which holds the sub-totals (this 
caninclude adevice name), andthe name 
of the key-field. As the program progresses 
it shows the number of countries it has 
found for each continent. When the pro- 
gram finishes (and don’t expect an instant 
result if you are using microdrives), you 
will have a new file called 
‘TOTCONT_DBF' (logical name Total) with 


11 entries, one for each of the 11 conti- 


nents. 

No, | hadn't realised there are 11 either, 
but now you can find the land area of 
continents you didn’t even know existed. 

It is quite easy to view the results. Each 
time you type ‘NEXT’ the next record will 
be displayed on the screen, allowing you 
to see the data for each continent. We 
shall look at better ways of viewing and 
printing Archive data another time. To 
calculate a grand total you can run the 
program again, using the sub-total file as 
the source file, and one of the other (now 
blank) text fields as the key field: (You will 
needto close Total, and then openit again 
with anewlogicalname, as Total is needed 
for the next new one.) In this way a third 
file will be created, containing one record 
of the grand totals. When you have fin- 
ished with a file you should close it, and if 
you don't wish to keep it you can delete it 
(eg by typing KILL"TOTCONT_DBF’). 
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display 


We shall now look at that statistic so 
beloved of cricket fans, the average - or 
arithmetic mean. The ‘Average’ proce- 
dure works in exactly the same way as 
Total. If you have just carried out a Total 
operation Gazet will still be opened and 
ordered. (If not you must enter the first two 
instructions shown above.) To produce a 
file of averages, the following line can be 
used: 


AVERAGE;GAZ"“AVERCONT “CONTINENTS” 


This will generate another new file, this 
time called AVERCONT (for which read 
Average for Continents). Again it will have 
11 records, but this time each will tell you 
the population and area of an average 
country from the continent concerned. As 
before, we can get a global average by 
running the procedure again, but using 
the new file, and a blank field as the key- 
field. 

A brief explanation of how it works may 
be of interest to some. It uses the trick of 
getting one program to write another pro- 
cedure, which it then loads and uses. This 
process happens twice. The first time is 
from the ‘CopyStruc’ procedure, which 
writes a program to create a data file with 
an identical structure. CopyStrucis astand 
alone procedure, which is useful for all 
sorts of other purposes. It requires three 
parameters — the logical name of the 
existing file, and the physical and logical 
names of the file to be created. 

The rest is done by the procs ‘Calc’ and 
‘MakeList’. Proc Calc does the bulk of the 
work, creating the temporary procedure 
which will do the adding up. However 
MakeList writes the actual addition and 
assigning routines. Each numeric field 
must have its own lines, both for adding 
extra entries, and for assigning a new 
number at the start of each subset. 
MakeListis called for each of these, using 
Opt to specify which. 

If Calc is being used to average (for 
which the ‘Av’ parameter is set to 1), 
MakeList is called a third time. This writes 
an extra procedure, proc Avtemp, in addi- 
tion to proc temp, which does the job of 


calculating the averages. After running 
either Total or Average, you can examine 
the temporary procedures by using EDIT. 
Don’t try changing them directly though, 
as they will be overwritten next time the 
program is run. All corrections and en- 
hancements must be made to the program 
which writes these procedures. 

Once the new procedures are written 
Calc steps through the source records, 
calling the temporary procedure (proc 
Temp) each time, and displaying the 
running total of records processed. Two 
global variables are employed. 
TEMPFILE$ stores a file name for the 
temporary procedure files —- use a ram 
drive device if you have one, to speed up 
execution; and SUBTOTAL keeps track 
of the number of records found for each 
subset. 

As printed, the program produces a 
bare minimum of output data, to perform 
the tasks in hand. One reason for this is to 
retain an identical file structure to the 
original. Programs, and sedit screens 
which use the source files may also be 
suitable for the new one. However there 
are plenty of possibilities for embellishing 
it, for anyone who fancies a bit of tinkering 
with the code. 

One possibility would be to add an extra 
record to the next file, in which could be 
stored the grand totals, or global aver- 
ages. A few additions to proc Calc, so that 
proc Temp can be called twice, would 
enable it to add each source record to 
both the first (for the grand total) and last 
(for the current subset) records of the new 
file. 

Another possibility would be to store the 
number of entries found for each key- 
field. To do this you would have to custom- 
ise proc CopyStruc, so that it added an | 
extra field. It would then be a necessary to 
assign SUBTOTAL to this field each time, 
in proc Calc. 

Both Total and Average can be used on 
any Archive data file, and will add or 
average all numeric fields except the key- 
field. A word of warning may be in order 
here. The figures produced will have more 
meaning in some cases than others. For 
example, the ‘gdp' field appears to be 
Gross Domestic Product per capita gdps 
for acontinentis a meaningless figure. (I'll 
leave you to work out why). The average 
gdp is a little more sensible, being an 
average of average figures. The actual 
per capita. (The currency is not specified.) 
The Total of per capita gdps for a conti- 
nentcan only be found by dividing the sum 
of total gdps by the sum ofthe populations. 

All of this goes to show that even with 
simple statistical work you must under- 
stand what the source figures actually 
show, which calculations are appropriate 
for your purposes, and what the resulting | 
figures mean. Without this you can pro- 
duce garbage statistics with any compu- 
ter, be it a QL, Unix workstation, or Cray 
supercomputer. 
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Long-awaited, much discussed, now revealed: 
Mark Knight prods the new WP from DP. 
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erfection is the new Digital Preci- 

sion word-processor. With sucha 

name to live up to, users might 

well expect a great deal from the 
program — if you like short reviews, it’s 
my opinion that users will be highly im- 
pressed. Great emphasis has clearly been 
placed on the need to make the program 
easy for existing Quill users to adapt to: 
Digital Precision have told me that they 
used a wide selection of beta-testers during 
this project, and that the beta-testers in- 
cluded some very dyed-in-the-wool Quill- 
lovers, 

Despite visual similarities to Quill (and 
many similarities in keypresses) both the 
feature list and the performance (in speed 
terms) of Perfection make Quill look poor 
indeed by comparison. Perfection not only 
outperforms Quill running on a QL, but 
seems to live up to the advertised claims 
of outperforming other programs (such 
as PC programs like WordPerfect) running 
on much faster hardware. The whole pro- 
gram shows signs of being an ambitious 
project designed to meet the needs of real 
users, well managed from start to finish. 

Perfectionis intended asa serious word- 
processor for the QL, both for the techni- 
cally competent user who wants to do 
serious work without having to down- 
grade to an MS-DOS machine and for the 
everyday Quill user who has found word- 
processing programs other than Quill too 
complicated or user-unfriendly. 


Slow Quill 


Quill has many faults — not the least 
being its speed — with perhaps a good 
claim to being one of the slowest word- 
processor programs written since micro- 
computers became popular. To be fair to 
Quill, it was written in a hurry by a pro- 
gramming team working without the 
benefit of a fully finished QL, with the QL 
release date looming. Given this, it is a 
tribute to Psion’s team that Quill has the 
advantages that it does. 

Digital Precision have been able to spend 
a lot more time on Perfection, and have 
had access to Ols for six years or more. To 
an existing Quill user who has found such 
programs as DP’s Editor or Editorial Spe- 
cial Edition too complex, Perfection will 
seem like a gift. Coming back to one of the 
core features, there is a strong surface 
resemblance to Quill, with the menu and 
prompt window at the top of the screen, 
the main text in the centre, and a status 
line at the bottom. Like Quill, the menu 
window can be switched off using F2 and, 
if present, it is updated to show the avail- 
able commands. Again similarly to Quill, 
the command menus are called up by 
pressing F3, but unlike Quill repeated 
pressed of F3 are used to cycle between 
the menus (A-B-C-D, or SHIFT /F3 to cy- 
cleinreverse D-C-B-A) rather than Quill’s 
less logical — and slower - F3 followed by 
oy, 


Sinclair/QL World May 1991 


Perfection has four of these menus, 
rather than Quill’s two, and so has more 
functions. Perfection has very good 
WYSIWYG (What you see is what you 
get) display features, showing superscript 
and subscript properly (as Quill does), 
bold text in a differing ink colour, and 
italics as italics, which Quill does not. For 
other printer fonts or features, a number 
of different paper colours behind the 
characters can be set up so that these are 
clearly indicated on-screen. 


Simple to learn 


The similarities to Quill make the pro- 
gram simple to learn for the less techni- 
cally minded, but Perfection has a feel 
very distinct from Quill, whose users fre- 
quently find themselves waiting for the 
program to catch up with them. I did not 
find this with Perfection. | can back up 
DP’s claim that the program has a simple 
and largely familiar user interface, as I 
had no manual of any kind - either on 
paper or on disk - for the first part of the 
review period, yet I experienced no dif- 
ficulties using Perfection. Some of the 
more advanced features (like program- 
mability) would require the manual, 
though possibly only while learning: but 
all of these seemed to me to be features 
that would be rarely used by the Quill 
veteran. 

Help in Perfection is great. When you 
press F1 to ask for help - which works 
even if the program disk is absent — your 
document is simply hidden from view 
while a help document instantly replaces 
it. The Help text lists all keypress combi- 
nations and their effects (including ones 
like CTRL/C and ALT/ENTER, which 
have special uses outside and inside Per- 
fection but which will be unfamiliar to 
many Quill users). It also explains status 
line codes and illustrates the hidden at- 
tribute characters — more on these later. 


Slow Quill 


Within the Help text all the usual Per- 
fection navigation commands work. 
Search is particularly useful, so you can 
find specific help on any item — a search 
for ‘para’, for example, would allow you 
to find all the commands that related to 
paragraph handling. Once you have fin- 
ished with Help, press Esc or Enter or 
similar to return — instantly - to your 
document. If you want to customise the 
Help text, or replace it with whatever 
reference or other work that you wish to 
be displayed in response to F1, all you 
need to do is to Load the Help text as you 
would any other documentand modify it. 

Perfection, where different from Quill, 
is different for sound reasons, and once 
the user gets accustomed to the difference 
Perfection seems the more sensible of the 
two programs. To illustrate: while Quill 
does provide default strings in response 
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to some prompts, it is inconsistent as it 
does not provide, say, a default Search or 
Replace string. Perfection always supplies 
an editable default provided the com- 
mand has been previously used: in this 
case, it defaults to the last strings searched 
for and replaced. With Perfection, the edit 
cursor is presented at the end of the de- 
fault string. Where Quill offers a default 
string - on Save or Load, for example -the 
edit cursor is at the start of the default 
string, which is not where it would ap- 
pear if the string had just been typed in. 

Perfection’s status line contains much 
more information than Quill’s. In addi- 
tion to what Quill provides, Perfection 
displays ten indicators, showing the sta- 
tus of CAPS LOCK, word wrap, case sen- 
sitivity, block status, justification, etc. The 
word count is more accurate than Quill’s, 
In addition to a Quill-type line count 
within the page, there is a readout for 
position measured in lines from the top of 
the whole document, for the number of 
characters in the document (two num- 
bers, onea total including hidden attribute 
characters and the other excluding them), 
for the total number of pages, the number 
of lines per page and the character code of 
the character beneath the cursor. 


Slow Quill 


Most OL text-handling programs are 
non-WYSIWYG: such programs are much 
easier to produce. A WYSIWYG text pro- 
gram (not desktop publisher) must have 
either a system of pointers into the file, or 
markers within the file, showing where 
changes inattribute occur. Perfection uses 
the marker system because the pointer 
system, while simpler to program, is 
slower especially when there are a lot of 
attribute changes and subsequent edit- 
ing. Perfection’s marker system comprises 
hidden attribute characters — like Bold on 
— which are invisible (except when you 
ask Perfection to reveal hidden codes) to 
the user, but whose effect is to switch an 
attribute on or off. In contrast, Editor’s 
system was to use visible markers (say B 
witha line above it for Bold on) which had 
no on-screen effect (Editor is not 
WYSIWYG even in document mode). 
Perfection way is better: bold appears 
bold. 

Part of the Perfection ideal is to respond 
instantly to the keyboard, so that work 
can proceed rapidly on a document: with 
this in mind, the program implements a 
lazy screen, as Editor does. The lazy screen 
effect is seen when you scroll through the 
document. If an up/down arrow key is 
held down for continuous movement, the 
cursor will first move to the top/bottom 
of the screen (as with Quill) but then, 
instead of scrolling the whole text screen, 
just the line containing the cursor is 
scrolled, The single line can obviously be 
scrolled much more rapidly than the 
whole window, and as soon as the cursor 
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is released the whole window is updated. 
For those who find lazy screen a distrac- 
tion or an annoyance — many Quill users 
will — it can be switched off so that the 
whole text screen is always scrolled as 
one unit. Even with the lazy screen 
switched off, Perfection is about twice as 
fast as Quill. 

There are also ‘lazy attributes’. This fea- 
ture is best described by illustration: after 
a jump from the top of a 400K document 
to the bottom, the program will present 
the text on-screen immediately, permitting 
all operations — including all editing and 
cursor movements - to be carried out, and 
then a few seconds later, will introduce 
the bold, italics or other attributes that 
have been set, painting over the visible 
text. This delay is the only thing that [ 
found that could, for me, bea slight irrita- 
tion. But as the delay is only significant 
with really long documents — say a hun- 
dred pages or so — it is unlikely to bother 
most users. | must stress that you do not 
need to wait for the attributes to catch up 
(even though the wait would be several 
seconds at most) and that no error or 
problem can result from this feature. 


F3 and shortcut 


Unlike Quill, Perfection hasa widerange 
of direct commands entered by pressing 
key combinations: in fact, everything that 
can be selected by pressing F3 and then a 
letter can also be selected by a keyboard 
‘shortcut’. This means that as users learn, 
they can if they wish bypass the menus 
entirely and go over to the system of 
direct keypresses, speeding up work 
enormously. There is also a macro inter- 
preter which allows your prerecorded 
sequence of keypresses to be played back, 
automating frequently repeated jobs. This 
programmability is only intended for ad- 
vanced users. 

Editor owners are still well served by 
that program for editing machine code 
files, files with initially unknown formats, 
and some other files containing certain 
non-printable characters. Editor, however, 
is much slower in document made, as the 
document mode was an add-on that com- 
promised Editor's philosophy of the clean 
file. Perfection is much superior to Editor 
for all word-processing, as well as for use 
as a simple database and for handling 
most types of Ascii files. Major annoy- 
ances with Editor include the require- 
ment to leave blank lines between para- 
graphs. Perfection of course, does notneed 
these. Editor is also painfully slow at 
reformatting paragraphs (getting a para- 
graph to honour changes made to margin, 
tabulation and justification settings) — 
Perfection is many times faster. Perfection 
— unlike Editor - also discriminates be- 
tween soft and hard spaces — hard ones 
are those you putin, or which were created 
when you opted to expand tabs (Perfec- 


tion allows asymmetric tabs). Soft ones 
were put in by the program when justify- 
ing: if you justify anything by mistake 
with Perfection, recovery is easy — with 
Editor, it would be a tragedy. 


Dual windows 


Another Perfection feature on many us- 
er’s wish-lists is the dual window mode, 
in which Perfection splits the screen into 
two windows, and allows one window to 
contain a snapshot into the text (at any 
position), while editing continues in the 
other window. At any time, a single 
keypress will switch editing between the 
two windows. This snapshot feature is 
mentioned in DP’s advertisements, but 
the ability toswitch between windows for 
editing was a bonus I had not expected. 

The integrated spellchecker isa brilliant 
addition. There are three modes of opera- 
tion, all of them very flexible. The most 
common mode in QL spelicheckers is the 
check-as-you-type one, where words are 
checked against the dictionary as you type 
them. In this mode, the Perfection 
spellchecker will beep when an error oc- 
curs, ensuring that the user can correct 
the mistake straight away; as an alterna- 
tive, the user can type the whole docu- 
ment and then come back afterwards and 
search for the marker character, which is 
put into the word when the mistake was 
noted by the program. You can type as 
fast as you want - you'll never beat the 
spellchecker. 

Documents loaded into Perfection can 
be checked in memory in one go, after 
typing or loading is finished. 
Spellchecking in this mode is extremely 
fast, well over 500 words per second on 
my test QL, with a fair number of typing 
errors in the document. This speed should 
not be taken as fixed, as it will depend 
upon the number of errors in the document 
being checked, the QL memory expansion 
in use, the average word length, and 
possibly other factors unknown to me. 


Peak speeds 


Moreerrorsin the text will meana slower 
performance, but with a new Trumpcard 
higher speeds are likely (DP claim a peak 
speed of about 1100 words per second on 
a QOL, 3000 on a Thor XVI or ST QL Emu- 
lator). A variation of the internal checking 
allows for a user-defined block (from any 
one point to any other point, or to make 
the definition of the area to be checked 
faster, from any given page to any other 
page) of the text to be checked. This is 
much better than forcing the user to check 
the whole document. Of course the block 
could be as small as a single word. 

It should be pointed out that the large 
dictionary (about 225,000 words) will not 
fit into QLs other than those fitted with 


the largest ram-size Trumpcard (with 
768K, giving the QLa total of 896K). There 
is a medium sized dictionary of around 
150,000 words — three times larger than 
the nearest QL competitor —for 640K QLs. 
With either the large dictionary in a 
Trumpcard QL or the medium dictionary 
in a 640K machine, there is still room for 
about 25 A4 pages in ram. There isa third, 
smaller (but still adequate) dictionary for 
those who want to multitask the program 
with other QL software, or who want to 
write really large (hundreds of A4 pages) 
documents. Of course it is also possible to 
use the medium dictionary with the 768K 
Trumpcard, allowing a small book to be 
spell-checked in memory. 

While on the subject of ram, Perfection 
is 30K smaller than Editor SE and only 
12K larger than Quill. More importantly, 
Perfection would appear to be more eco- 
nomical with its use of ram than other 
word-processors. Quill grabs all the ram 
in the machine unless active steps are 
taken to stop it doing so: also, Quill has 
undocumented restrictions preventing it 
from being used with really big files. The 
Editor is better behaved, allowing you to 
specify the amount of memory to be used: 
however, there is no way to change this 
without losing the loaded document, and 
changes often result in heap fragmenta- 
tion. 


Memories 


When memory becomes short, Editor 
makes you wait while it garbage-collects 
- this can take from a few seconds to an 
annoying five minutes or so — and can 
easily run out of memory. Perfection has 
none of these problems: it grabs and re- 
turns 4K blocks of memory automatically, 
so it never has more or less memory than 
it needs, and it does this without frag- 
menting the heap. Indeed, Perfection has 
the management capabilities of a small 
operating system. Editor also uses up more 
ram than Perfection when storing a file: it 
has an overhead of 5 bytes per line (4 for 
address, 2 for length less 1 for missing eol 
character), which foraverage lines is about 
10% loss: better than Quill. Perfection’s 
overhead is 48 bytes per 4K, plus a little 
slack space per block (which helps make 
editing faster) —so that the loss is minimal 
at about 2%. 

I suggested to: Digital Precision that 
using the large dictionary would slow the 
impressive checking performance, but 
they informed me that the dictionary sizes 
do not affect checking speed noticeably. 
This is because of the unique dictionary 
structure, which is apparently highly in- 
dexed to a variable depth and takes ac- 
count of word-frequency. 

Users may create their own dictionaries 
too, and the Perfection spellchecker can 
be instructed to use two dictionaries at 
once, allowing supplementary dictionar- 
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ies for technical or other specialised pur- 
poses to be constructed. Any of the sup- 
plied dictionaries can be the main diction- 
ary, with the user’s own dictionary 
searched either first or second, depending 
upon experience of which results in faster 
checking. 

All dictionaries are highly compressed. | 
saw the word list for which the large dic- 
tionary was constructed —in uncompressed 
form, it occupies 2.3 megabytes, which is 
very big. 


Spellchecker 


The third spellcheck mode is to ask for 
the checking of a file already on disk, and 
as the spellchecker is a separate, 
multitasking program, this can even be 
done while the user is also editing another 
document. Perfection has a software con- 
vention for communicating with its satel- 
lite programs (of which the spellchecker is 
one), so that the spellcheck program is just 
another option on the command menu. 
This has been done so that the non-technical 
user, who is terrified by — or hates — com- 
plexity, need not know or care that the 
spellchecker is a separate program. 

Another satellite program provided al- 
lows graphics saved from Professional 
Publisher to be incorporated into Perfec- 
tion pages, even allowing more than one 
illustration per page. Of course, you must 
not try to use a daisywheel printer for 
graphics output (for all other purposes, 
Perfection works fine with all types of 
printer — daisywheel, inkjet, dot matrix 
and laser). I felt that Perfection would have 
been even better if it was also able to use 
Eye-Q graphics files, as more people own 
Eye-Q than Professional Publisher, and 
more people would be willing to purchase 
the cheaper program for the purpose of 
simply adding graphics to their pages. 
Digital Precision replied that they chose 
the Publisher format as it is more flexible, 
allowing image sizes from postage stamp 
to full page A2, and that very high definition 
can be obtained with output in quad den- 
sity mode from big pages. 


Printer driver 


Perfection purchasers who have many 
Quill files, and who have gone through the 
sometimes considerable pain of setting up 
printer drivers for their own printer may 
dread the thought of starting all this again 
with a new program. Perfection avoids all 
hassles by automatically using Quill printer 
drivers without alteration. Of course you 
can add features to these drivers after the 
automatic conversion, for example adding 
your printer’s codes for italics, or adding 
more translates than Quill permits. If you 
do not have a suitable Quill printer driver, 
you can use the supplied default drivers or 
modify them or start from scratch and 
build your own. 
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Converting from a Quill document to a 
Perfection document could not be simpler 
— there is no conversion required. Perfec- 
tion will load Quill documents just as it 
loads Ascii or Perfection files — it auto- 
matically discriminates between them, and 
at a similar speed to that of Quill (though 
very long Quill documents will be loaded 
much more quickly by Perfection). When 
Perfection saves a document, it does so 
either in its own native format or as Ascii - 
you select which, the default is its own 
format. I fully understand why Digital 
Precision have not bothered to give the 
user the option to save the file in Quill 
format ~ I can see now reason for the user 
of Perfection go back to Quill. If the user 
must do this, however, he can output from 
Perfection in Ascii, and import into Quill. 

Minerva works fine with Perfection. 


Benchmarks 


Perfection is the fastest word-processor 
for the QL, despite it being WYSIWYG. 
The other WYSIWYG word-processors for 
the QL are Quill and Text *; while Text®’ is 
faster than Quill (even with TurboQuill Plus) 
Perfection is much faster than any of them. 
Thisis perhaps not surprising as the leader 
of Perfection’s programming team, Steve 
Sutton, has a record of producing fast and 
compact code — he is the principal author 
of Lightning. 

The speed of Perfection is such that it is 
more than sufficient to see off the non- 
WYSIWYG brigade as well: even the 
quickest editors for the QL, including 
Digital Precision’s own, are nowhere near 
as fast. Flashback Special Edition, which is a 
card-file database renowned for its excel- 
lent speed, was used as a benchmark by 
Digital Precision during the development 
of Perfection, I am informed, and there is 
virtually no speed difference between the 
two on tests involving scrolling and 
searching — a compliment to both. 

Benchmarks are of limited use, but care- 
fully chosen they will give a general idea of 
the relative speed of programs. I’ve used 
small, medium and large test files for the 
tests, but omitted to run Quill on the large 
one as I simply do not have the time to 
spare (some of the tests with Quill on the 
large file could have taken hours or days to 
complete). 

Versus Editor Special Edition in its nor- 
mal mode: 

Perfection took 13 seconds to load the 
large file: Editor SE took 116 seconds. To 
find a unique string towards the end of the 
file, Editor SE took 163 seconds. Perfection 
took less than three seconds: indeed, tim- 
ing Perfection on some tests was very hard 
because it was so fast. 

Perfection was three timesas fast as Editor 
SE when globally replacing a common 
string. Scrolling tests — performed with 
lazy screen off — showed Perfection out- 
performing Editor by around 12%: both 
are very fast. 
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Versus The Editor Special Edition in its 
document mode: 


This is the mode in which Editor behaves 
more like a word-processor, albeit at a 
considerable cost in speed. Perfection took 
5 seconds to load a file and Editor SE took 
about 7 minutes (about 90 times slower). 
Perfection’s navigation to the bottom of 
the file was instant, while Editor SE took 17 
seconds (Editor SE in normal mode would 
also have been instant — it is the overhead 
of having to calculate page breaks, etc, that 
slows it down). On Perfection, deleting 
and adding lines, as well as changing page 
length were all virtually instant (taking a 
small fraction of a second): Editor SE was 
sluggish, maybe upto a thousand times 
slower. Editor SE was four times slower on 
a global replace, and 35% slower on scroll- 
ing. 


Versus Quill: 


Perfection was 60 times faster than Quill 
at importing an Ascii and 10 times faster at 
loading an ‘own format’ file. Saving was 10 
times faster on Perfection. Perfection is 
about 60% faster at scrolling down and 
100% at scrolling up, again with lazy screen 
disabled. If lazy screen is on, Perfection is 
many times faster. TurboQuill Plus helps, 
but Perfection still has a huge advantage. 


Good... 


Of course, different types and shapes of 
file will produce somewhat different tim- 
ings — | am not aware of any bias in my 
choices. It is inconceivable that my overall 
favourable conclusions about Perfection’s 
speed could be adversely affected by choice 
of file. 

Digital Precision have made many claims 
for Perfection, perhaps the biggest implied 
by the name chosen for the program. The 
name is certainly brave, perhaps begging 
to be shot down, but I would be dishonest 
if I gave it anything other than an enthusi- 
astic review. I have found it to be simply 
excellent, easy to use, fast, packed with 
features (far more than I have space for in 
this review —I haven’t even mentioned the 
configurator) and very well thought out. I 
can find little to say that will convey just 
how good this program is, except to quote 
Digital Precision’s own advertising: Per- 
fection will blow your socks off. Perfection 
is the program that Quill users have been 
waiting for. 


INFORMATION 

Program: Perfection. Needs 256K Ram 
minimum, plus at least one disk 
drive. 


Price: £79.95. With Spellchecker, 
£119.95 

Publisher: Digital Precision Ltd, 222 
The Avenue, London E4 9SE. Tel. 
081 527 5493. 
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THE NEW 


USER GUIDE 
THE SCREEN Pa 


In the third of our New User Guide series, 
Mike Lloyd covers the subject matter of 


Chapter 3 of the QL User Guide. 


he screen is an essential part of any computer system because it is where the computer 
communicates with the user. A great part of the operating system of the QL is devoted to 
managing the screen display. Similarly, a large percentage of Superbasic commands are 
used to produce images on the screen. This section of the New User Guide introduces 
everything you need to know in order to understand the way the QL handles the screen. 
Pixels Television pictures are made up of lines of dots, each dot called a ‘picture element’, or pixel. 
Modern television broadcast pictures produce high-quality pictures with 625 lines. Computers tend 
to have lower numbers of lines, typically around the 200-300 mark. The QL has 256 lines. Depending 
on the display mode each line has either 256 or 512 pixels. 

The QL's designers allocated 32 kilobytes (82Kb of the computer's 128Kb memory to managing 
the screen. In high-resolution mode, or monitor mode, this memory limit means that each pixel can 
be one of four colours. The low-resolution, tv, mode has half as many pixels, allowing more 
information to be held for each pixel. Not only does the tv mode have eight colours, but the pixels 
can be individually set to flash. 

The disadvantage of using tv mode is that vertical lines are twice as thick as they would appear 
in monitor mode. For television users the extra width of the characters can make text easier to read, 
but monitor users generally prefer to use the high-resolution screen mode in order to place more text 
and graphics on the screen. 


Figure 1: The screen-wide pixel co-ordinate system. 


Pixel (0,0) 


Th . d The computer screen is best imagined as a piece of electronic graph paper where each tiny screen 

e g rl can be painted with a given colour. The location of each square in the grid is described by counting 
how many squares across and down from the top left square it lies. Moving clockwise around the 
screen, the four corners are at pixel locations (0,0), (511,0), (511,255) and (0,225). The horizontal 
co-ordinate is given first. 
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Windows 


Figure 2: the window co-ordinate systems 


Top left cosner of 
Top left corner window#t Pixel (0.0) 


nf screen Character position (0.0) 


AT1.3 
PRINT “HFL LO" 


LINE 18,5 TO 36. 30 


Graphics position (0,0) 


When a programmer issues a command such as PRINT “HELLO” the QL calculates where on 
the screen the letters must go. It then looks up in its operating system the details of what pattern 
of pixels forms each of the letters. The letter patterns are transferred to the correct place in the 32Kb 
memory area reserved for the ‘screen map’. Fifty times a second this memory map is accessed by 
the QL in order to send the current screen picture to the tv set or monitor. 

Itis quite feasible, if alittle unfriendly, for computer programmers to make changes to the contents 
of the screen map directly. It is much easier to use SuperBasic commands to specify where lines, 
curves and characters are to be drawn. With SuperBasic, the programmer tells the computer what 
is wanted and the QL then gets on with the task of fulfilling that request without the user needing 
to know how many pixels of what colours will be printed where. 

It is very useful to be able to tell the QL exactly where on the screen text should appear — for 
example, to centre a heading or program name. Similarly, if we are going to use the QL to draw 
graphics there must be a way of specifying where lines start and finish. It would also be nice to be 
able to move windows around, and change their sizes, to meet the needs of particular programs. 

In order to do any of these things, the computer's method of locating points on the screen must 
be used. The QL is more advanced than most other computers because the screen can be broken 
down into separate areas, called windows, each acting as if it was a screen by itself. 

When the QL is turned on it has three screens windows opened automatically. These are called 
the default windows and are numbered 0, 1 and 2. Each has a specific purpose: Window 0 is the 
command window where your typing normally appears and where error messages are displayed: 
Window 1 is the default window where printed text output and graphics appear if no other window 
is specified, and Window 2 is the listing window for SuperBasic programs. Other windows can be 
opened using different numbers to identify them, but this will be covered later in the guide. 

The size, position and colour of windows can be changed using simple SuperBasic commands. 
Window size and location are specified in pixels, and a typical command to specify a window's 
attributes is: 


WINDOW 100, 100, 206, 78 


WINDOW is a SuperBasic keyword. It is followed by four parameters separated by commas. The 
first pair describe the dimensions of the window and the next pair describe the location of the top- 
left corner of the window in relation to the top-left corner of the screen. The command can therefore 
be translated into English to read “Move the main window so that it is 100 pixels square with its top 
left pixel located 206 pixels across and 78 pixels down from the pixel in the top left corner of the 
screen”, 

You are already aware that the QL can increase the number of colours it can display by halving 
the number of pixels it draws. The QL’s operating system is clever enough to ensure that a 100x100 
pixel window stays the same size no matter what mode the screen is in. Always think of the screen 
as being a grid of 512x256 pixels, no matter what mode the computer is in. 

A WINDOW command makes no immediate difference to what you can see on the screen. The 
computer has merely changed its understanding of where the window lies ready for the next 
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window-related command. To see where the window has moved to, change its colour so that it is 
different from the background and clear it with the CLS (clear screen) command introduced last 
month. 

SuperBasic has two very easy commands to change screen colours. One changes the 
background colour and the other changes the foreground colour. Text and graphics are drawn in 
the foreground colour on pixels the colour of the background. The keyword must be followed by a 
parameter to indicate the required colour. The computer does not understand words such as blue, 
red and green, but it recognises colours by a number system, as follows: 


TV MODE MONITOR MODE 
Colour Number Colour Number 
Black 0 Black Oor 1 
Blue 1 Red 2or3 
Red 2 Green 4or5 
Magenta 3 White 6or7 
Green 4 

Cyan 5 

Yellow 6 

White Z 


The PAPER command is identical to the INK command except that it controls the background 
colour of the window. The choice of colours and the numbers by which Superbasic identifies them 
are the same as for INK. 

Colours can be described by any number between 0 and 255, even though the colour chart above 
suggests that the maximum colour value is 7. Numbers higher than 7 produce speckled effects 
which will be described in detail later in the Guide. Feel free to experiment, but be aware that the 
results can make text very difficult to read. 

Here are a set of three commands which change the window location and colour it green: 


WINDOW 80, 80, 100, 48 
PAPER 4 
CLS 


Should you enter the above commands on your computer, you will notice that the window is not 
square, even though there are the height and width of the window are equal in terms of numbers 
of pixels. This is because pixels are not square but rectangular, being taller than they are wide. True 
squares can be made by specifying more horizontal pixels in the ratio of around 1.6:1, such as: 


WINDOW 162, 100, 0, 0 


Experiment with the WINDOW command to move the default window around the screen. If the 
QL detects an impossible window location it will print an explanatory error message. 

All of the WINDOW, PRINT, PAPER and CLS commands used up to now have affected the main 
window, leaving the listing window and the command window unchanged. In order to direct such 
commands at other windows. an identifying number is essential. 


Communication between the computer and each window is by a ‘channel’. Channels can be 


connected to many things, including windows, printers and files, and each channel is numbered. 
With the main window the identifier can be included or omitted as desired. As explained earlier, the 
command window at the bottom of the screen is WINDOW#0 and the listing window is WINDOW 
#2. The hash before the number indicates to the QL thatit is a channel identifier and not aparameter. 

All commands related to windows can be followed by a channel number. Thus, the PAPER 
command can be followed by a hashed number, such as PAPER 2, 4, PRINT is another window- 
related command which can be treated in the same way. Note though that if these commands take 
a hashed number there must be a comma between the window number and the first parameter. To 
demonstrate this principle, let us relocate and recolour the listing window and print some text in it: 


WINDOW #2, 200, 200, 50, 10 
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Ink and Paper 


~ Channels 
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PAPER #2, 5 
PRINT #2, “This is the listing window” 


The PAPER command will turn the window light blue, or cyan, if the QL is in tv mode, or the 
window will be green in Monitor mode. 


When the QL is first switched on the user must choose between tv mode and monitor mode. 

However, there is no reason why that mode mustbe used throughout the computing session. There 

MODE4 and a is a SuperBasic command called MODE which takes a single number as its parameter. MODE 4 
switches the QL into its high-resolution, four-colour mode most suited to monitors and MODE 8 
provides the low-resolution, eight-colour mode which TV users most frequently use. 

You should be beginning to see by now that SuperBasic is logical and simple way of expressing 
things. Commands are made up of keywords and, optionally, parameters. Most of the parameters 
used so far have been numbers, but the PRINT command can be followed by a text parameter 
enclosed in inverted commas. Although it might be difficult for programmers to remember, it is 
convenient for the computer to recognise things such as colours and channels by numbers rather 
than by names. 

At the beginning of this section of the User Guide we learnt about the screen-wide pixel co- 
ordinate system used to locate windows. Each window has its own co-ordinate system with its 
pixels described as offsets from the top left corner of the particular window they belong to. This is 
very rarely used by SuperBasic commands. 

There is a more useful co-ordinate system linked to each window which determines where text 
is placed. Like the pixel co-orindates the origin — the point described as (0,0) — is at the top left of ee 
the window. However, each location on the grid is exactly large enough to hold a single character. 
This is a very convenient arrangement because the QL has six different text sizes: the character 
co-ordinate system adjusts itself automatically to suit the current character size chosen. 

Character co-ordinates are described by the AT command. AT is always followed by two 


The AT parameters to represent the horizontal and vertical offset from the top left character in the window. 
Thus: 

command 
AT 5,6 


PRINT “HELLO” 


will print the word HELLO beginning at a character position five lines down and six places in from 
the top left corner of the window. Because AT is a window-related command you would expect it 
to be able to take a channel number, and so it does. AT 2, 4, 2 will affect the print location of the 
next text printed in the listing window with the PRINT 2 command. 

There is yet another co-ordinate system linked to windows to control the drawing of graphics such 
as lines, curves and circles. This is known as the graphics co-ordinate system. It is particularly 
clever because it changes its scale so that no matter what the size of the window its height always 
equals 100 graphic units. Another invaluable feature is that a circle drawn in monitor mode can be & 
re-drawn exactly the same size in tv mode, even though there are a different number of pixels and 
each pixel is a different shape. The origin of the graphics co-ordinate system is at the bottom left 
of the window. 

To experiment with the graphics capabilities of the QL there are two commands which will be fully 
explained in the next section of the Guide. 

Lines are drawn using the LINE command. Four parameters are needed: two to describe the 

Li ne and location of the start of the line and two to describe where it will end. A new keyword, TO, separates 


. them. Two examples are: 
Circle 


LINE 20, 40 TO 20, 80 
LINE 10, 90 to 50, 30 


Circles are drawn by the CIRCLE command. The CIRCLE keyword takes three parameters: two 
to describe the location of the centre of the circle and the third identifying its radius in graphics units. 
Remembering that no matter what shape and size a window is itis always 100 graphics units high, 
a circle touching the top and bottom of the window can be drawn by the command. 


CIRCLE 50, 50, 50 e 
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rchive is the type of 

program which is 

easily neglected, be- 

cause it requires a 
fair amount of time and atten- 
tion to be devoted to it before 
satisfactory results are ob- 
tained. It is no Quill; you can- 
not be familiar with most of it 
after one half-hour session. 
That does not make it worth- 
less; far from it. What is almost 
essential, though, issomestudy 
of the programming language 
provided withit. Judging from 
personal experience, and the 
letters we have seen over the 


unable, or unwilling, to make 
use of this language, and the 
Archive cartridge tends to sit, 
| unused, in its pouch. 


Lists 


The desire to put a database 
onto the QL doesn’t disappear 
with Archive, however. It is 
characteristic of people who 
use micros that they like to keep 
lists. Many users presumably 
fail to realise the potential of 
word-processing programs for 
keeping lists, and hanker after 
some way of being able to uti- 
lise the power of Archive with- 
out having to learna language. 
In some respects, Flashback al- 
lows such users to make their 
lists relatively painlessly, but it 
does lack the power of Archive, 
in so far as it has no built-in 
programming language, and 
that means it is not fully satis- 
factory for some users. The in- 
troductory notes supplied with 
DBEasy state that the pro- 
gram’s aim is to enable users to 
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years, many users are either’ 


DBERSY MAIN MENU 


ingle Mode 
Multiple Hode 
Backup 
Directory 
Switch tode 
Program Device 
Screen Colors 


Quit DEEasy/ARCHIVE all done 


AYORTWARE FILES 
DB Easy 


DBEasy provides a user-friendly interface with Archive. 
Bryan Davies tries it out. 


9182/18 
16:42:51 


Day 41 of 1991 
11 minutes since stort 


find, search, locate single print add,alter delete 
select order print, export copy, sut,add ol ter delete 
backup the flpl_income_dbf database 

directory of davice,copy or delete files 

suitch, add/crente, change specs of a database 
change expected program device 

change screens colors 


Wee orrcu keys (+}o4 


Figure one: the DBEasy main menu screen. 


have some of the power of the 
Archive language available to 
them, without the pain of 
writing routines themselves. 
That is, DBEasy was written to 
provide a user-friendly inter- 
face with Archive. 

Before going into the details 
of the program, it should be 
pointed out that the review 
copy (version 1.2) was received 
some time ago, and became a 
victim of the problems suffered 
by QL World in 1990, so there 
may be a later version avail- 
able. The price quoted for the 
program when thereview copy 
was supplied was £23.95 on 
5'/ain disk and £25.95 on 
microdrive cartridge, but it is 
advisable to check on current 
prices before ordering. The 
purchaser should specify 
whether the program is needed 
for a basic, or expanded- 
memory, QL. The F2 (tv) screen 


mode is not usable with either 
version. The review copy was 
the floppy disk, expanded 
memory, version. You are 
warned in the instructions that 
some operations may require 
the loading of program mod- 
ules from the program device, 
and this may involve the 
swapping of cartridges if the 
QL has no memory expansion. 

The nine pages of instructions 
on A4 paper are easy to read 
and understand. The first two 
pages contain a brief explana- 
tion of database structure, and 
a description of how a DBEasy 
record is structured. Sensibly, 
the point is made that it is use- 
ful to keep text and numeric 
quantities separate ona record, 
but that various forms of 
nominally-numeric quantity 
are best treated as though they 
are text. The examples given 
are the numbers on bank 


cheques, and postal codes. 
While both are wholly or par- 
tially numeric, neither is sub- 
ject toany calculationsand they 
are, effectively, no different to 
alphabetic text data. 

The DBEasy record has 10 
lines for text field data, with up 
to 63 characters in each field, 
and a further six fields for nu- 
meric data. The user inserts 
field names as desired; there is 
no requirement to give names 
to all, or any, fields. Any char- 
acters on your keyboard can be 
used in a field name, up to 12 
characters maximum, and 
names can be changed at any 
time. There are two additional 
fields, which cannot be named 
by the user; one is for the date 
(when the record is created), 
unless the user chooses to use 
it for something else, and the 
other — called ‘Keys’ — is for 
specifying a category (or cat- 
egories) into which the record 
falls. For example, a name and 
address database might have 
the categories ‘QL user’, 
‘friend’, and ‘supplier’. Since 
field names can contain char- 
acters thatare outside the range 
which is standard to most 
printers, the user may have to 
run the Psion INSTALL BAS 
routine to alter the 
PRINTER_DAT file and insert 
translations which tell the 
printer how to handleany ‘odd’ 
characters. 


Options 


Once the chore of typing-in 
records has been carried out, 
DBEasy makes life easier; in- 
formation can be displayed on 
the screen or sent to the printer, 
numeric fields can be summed 
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onthe screen orin the printout, 
and data can be exported to 
Abacus, Quill or Easel. 

The program boots up with 
an initial date and time check- 
ing/setting routine. You are 
advised to have the Archive 
program file ready in a drive; 
to save time, it would be on the 
same disk as DBEasy, but 
DBEasy expects tostart Archive 
from its own boot file and will 
re-boot itself if you don’t either 
rename the initial boot or alter 
the line in it which calls Ar- 
chive (to get rid of the unnec- 
essary Archiveboot). Although 
the proffered device names are 


= fCind) s(eanch) clont) Loc tec) moe Ving) aD dial edi i 


Figure two: the main database screen. 


the usual ram, flp and mdv, 
there is an ‘Other’ option, so 
that you can enter wini_etc if 
desired. 

Once Archiveisrunning, you 
key in RUN ‘flp_DBEasy’, and 
the program starts. The screen 
displays a brief running com- 
mentary of what is going on — 
a good idea when the loading 
procedure takes more than a 
few seconds. A log is kept, 
showing both the names of all 
the defined databases and that 
of the database file last used; 
the program checks this log 
and loads that file, if possible. 
The screen display when such 
a file has been loaded is shown 
in Figure one. The displayed 
menu covers the main require- 
ments for a complete work 
session, allowing database 
functions, some re-configura- 
tion, and housekeeping op- 
erations. A single-character 
cursor with a marker arrow to 
its left is moved to the desired 
option with the up/down cur- 
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sor keys, then the option is se- 
lected by pressing the Space 
bar. 

Commenting on the menu 
options in their order, Single 
Mode provides the familiar 
Archive functions Find, Search, 
Locate, Alter, Delete, plus two 
others, Single Print and Add. 
Choosing this option brings up 
the main database screen, as 
shown in Figure two. The ac- 
tual options on this screen are 
named somewhat differently 
from those listed for Single 
Mode, but they are fairly self- 
explanatory. There is no facil- 
ity to step forward and back- 


ward withina database, which 
seems a rather surprising 
omission. You can move to a 
specified Record Number. 

As is normal in Archive, Lo- 
cate is the fastest searching 
function, but it works only for 
the first ordered field, and the 
file has to be Ordered for it to 
work; this search method is 
case — sensitive. Find is the 
slowest operator, and looks for 
any specified string, anywhere 
within the text fields of all 
records. It is stated to operate 
in the case-significant mode, 
but it appeared to ignore case 
(as one would expect from the 
Archive definition of it). 

Search matches a specified 
string within a particular text 
or numeric field. Selection of 
Search is followed by quite 
comprehensive sets of choices 
of qualifiers, including Yes/ 
No/Exit for ‘Ignore upper/ 
lower case’. Figure three 
shows how a Search operation 
is specified, the selected quali- 


fiers being marked by arrows. 
The field ‘From’ and string ‘Fi’ 
have been selected, the ‘Con- 
taining’ qualifier indicates that 
the string should appear (any- 
where) in the field, and the ‘No’ 
qualifier specifies that the 
search should be for the typed- 
in case of both string charac- 
ters. The selected record in this 
case was the one shown in Fig- 
ure two. 


Commands 


Insert, Alter and Delete use 
the basic Archive procedures; 
Insert is what was called Add 
on the prior menu. Confirma- 
tion is requested before a de- 
letionis carried out. If there are 
further records having the 
specified string, they will be 
displayed when Continue is 
selected. Where the Record 
Number of a desired record is 
known, it can be displayed by 
means of the Record option. 
When Print (Single Print, on 
the prior menu) is selected, you 
have the option of printing the 
whole record, a single line, ora 
label. The whole record is es- 
sentially what is shown on the 
screen, minus the command 
and status information, The 
‘Line’ option printsasingle line, 
containing basic information 
from the current record; in the 
case of the record shown in 
figure two all that is printed is: 


2 (Record hash) Fink, M (From) 
DBAddres (For) 22 (Amount) 


The field names in brackets 
here are not printed out. The 
Label option applies only toa 
name and address database, 
and prints at the left margin, 
which might be too far left for 
label stationery, and wouldn’t 
look too smart printed directly 
on an envelope. 

Multiple Mode displays up 
to 10 records on the screen si- 
multaneously, in an abbrevi- 
ated, line-per-record style, as 
shownin figure four. There are 
several options on the sub- 
menu displayed in this mode. 
In the illustration, Order has 
been marked for selection. To 
Pageis used to list other records 
if there are more than the 10 
which can be displayed on the 
screen simultaneously. Select 
hasasub-menu of five options. 
You can select on any of the 
entries in the key field for ex- 
ample, "QL" in the name and 
address database. You can se- 


lect by field, or by the occur- 
rence of a specified string 
within a record. Include/Ex- 
clude options are offered once 
the selection has been made. 

A large database file could be 
‘refined’ in this way, so that 
only a small section of the 
records is displayed. Reset 
makes all files current again 
after Select has excluded some 
of them. Single changes opera- 
tions back to Single Mode. 
Copy allows any database file 
to be copied; that is, another 
file with a different name can 
be created, having exactly the 
same contents as the one from 
which the copy is made. This is 
useful for the initial creation of 
a backup file. Chg Dis allows 
the user to alter the way in 
which records are displayed, 
by changing any or all of the 
three fields listed; the option is 
given to make the change(s) 
temporary or permanent. Or- 
der is the Archive function to 
place records in order, so that 
the Locate function may be 
used with them. You can order 
the database on up to three 
fields, in ascending or de- 
scending order. Sum is only 
valid if there are numeric fields 
in the database; provided a 
numeric field has a label (field 
name), the contents can be 
summed. Prt Rec, Prt Lin, and 
Prt Lbl are print options, for 
the complete record, a single 
line record summary, or an 
envelope label. The printout 
can be given a heading; a par- 
ticular sequence of records to 
be printed can be specified; the 
number of lines per record can 
be specified (to alter record 
spacing), and printer, screen 
or file can be selected as the 
output device. 


Printing 


Printing to a file creates a file 
suitable for Import into Quill. 
Figure five shows the screen 
with all selections made for 
printing to the screen. Insert, 


_Alter and Delete are the nor- 


mal Archive commands. Quit 
allows DBEasy to be closed 
down, whereas Exit (an option 
on several sub-menus) merely 
takes the user back to the pre- 
vious screen. Export is the op- 
tion for producing a file to be 
Imported into Abacus. Files 
produced this way appeared 
to be Import-able without dif- 
ficulty into Abacus; as is nor- 
mal with this program, Import- 


ed files lose their (text and nu- 
meric) field names, but you can 
easily insert the correct names 
in place of the ones Abacus in- 
vents. 

Backup allows the current 
database to be backed-up to a 
different device. The user can 
opt to have the device format- 
ted automatically before the 
backup copy is made. A name 
containing the number of the 
day of the year is offered for the 
backup copy, allowing you to 
pick a particular backup froma 
set if corruption or another 
factor necessitates re-use of an 
old database version. 

Unlike some major QL pro- 
grams, the Psion quartet per- 
mit a limited amount of house- 
keeping activity to be per- 
formed from within the pro- 
grams themselves. The Backup 
option just described is onesuch 
activity, and the Directory op- 
tion adds both a directory list- 
ing (of any of the available de- 
vices) and Copy or Delete to 
this. The directory lists all files, 
regardless of type, and uses 
most of the screen, printing the 
files in columns to make it un- 
likely there is any overflow; it 
gives the total and available 
space on the medium. A small 
box presents the options to 
Copy or Delete any of the listed 
files, singly. Very simple and 
straightforward — it’s a pity 
some other suppliers can’t in- 
corporate this kind of thing into 
their programs. 


Display 


Choosing Switch Mode pro- 
duces a display of all the data- 
base filesin the log. Asub-menu 
offers the options Use, Print, To 
Page, Add, Change, Remove 
and Clone. Use enables the 
current database to be replaced 
by any of the others listed; this 
is a two-stage process, as the 
replacement database is ini- 
tially only marked on the log 
(you might want to use some of 
the other options with it), and 
you have to Exit to make it the 
active database. The Print op- 
tion sends a copy of the record 
format for each of the databases 
in the log to the printer. Once 
the log contains too many files 
to be displayed on the screen 
simultaneously, the To Page 
option has to be used, to access 
those files which are not cur- 
rently displayed. 

When a new database is to be 
created, the Add option is cho- 
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sen. This presents the blank 
record screen and guides the 
user step-by-step through the 
process of inserting details of 
the new database. Change al- 
lows the user to select a data- 
base record format and make 
changes to the field names. A 
database can be removed from 
the log with the Remove op- 
tion; this action has to be con- 
firmed, and does not result in 
the deletion of the database it- 
self. A copy of a database can be 
made with Clone. The record 
screen for the chosen database 
is displayed, and the user is in- 
vited to make changes to the 
record format, which will be 
useful when it is necessary to 
create additional databases 
which differ only in detail from 
an existing one. 

As might be expected, the 
Program Device option allows 
you to change the default pro- 
gram device. Itdoesa little more 
than this, though; after the new 
device has been specified, you 
are presented with a directory 
of it and asked whether or not 
the program files are currently 
onit. If the files are on it, you are 
asked to confirm that the change 
should be made permanent (ie 
the appropriate file has the 
change written to it) but, if the 
files are not there, the option 
becomes invalid. 

Screen Colors allows the user 
to set Ink and Paper in both the 
heading area and the main work 
area. The program operates in 
Mode 4, so the colour choices 
are red, green, white and black. 
Quit DBEasy / ARCHIVE offers 
the choice of leaving just the 
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Figure three: specifying a Search operation. 


DBEasy routines, or closing 
down Archive as well. 

Four sample database files are 
supplied (one is shown in the 
illustrations). They are suffi- 
cient to give even an inexperi- 
enced user a fair idea of how to 
go about setting-up a database. 
Since it is quite easy to change 
field names and other details, 
the samples could be used as 
the basis for the user’s own 
databases. The DBEasy routines 
can be inspected and altered, as 
with any other Archive Proce- 
dures. The suppliersuggests the 
user might want to customise 
the routines to obtain printouts 
and calculations to meet spe- 
cific personal requirements. 

Numeric fields can be 
sununed. If more-complicated 
mathematical manipulation is 
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Figure four: record summary in Multiple Mode. 


required, the database should 
be exported to Abacus. The 
supplier suggests one possible 
use of DBEasy is the keeping of 
complicated book-keeping 
records, because of the facility 
to make use of Abacus for cal- 
culations. 


Memory 


Archive and QL memory 
place restrictions on the number 
of records one can have in a 
database. It is pointed out that 
the later version of Archive 
(2.35) permits the use of more 
records than do the earlier ver- 
sions. Ordering reduces the 
number of records allowed. 
Where lack of memory is the 
limiter, you are advised to split 
databases into two parts (when 
the displayed memory value 
drops to about 1000 bytes), The 
Multiple Mode option allows 
the user to select a portion of 
the current file and copy it toa 
new file; do this with the two 
portions of the current file, then 
use these and abandon the 
original complete file. 

Users of Archive may well 
develop something of a phobia 
about the command OPEN, 
having experience its failure 
following field corruption. 
DBEasy tries to minimise the 
possibility of corruption by 
keeping the current database 
file closed most of the time, and 
opening it only when the Insert, 
Alter, Delete or Order com- 
mands are in use. Backup of 
databases is an essential action, 
andis made straightforward by 
the Backup menu command. 


Sinclair/QL World May 1991 


= 


On the negative side, the pro- 
gram does not operate ina way 
one would call fast, although 
the speed may well be accept- 
able for the kind of work it is 
likely to be put to. It wouldn’t 
be difficult fora user with even 
limited knowledge of 
SuperBasic to modify the boot 
and program files and arrange 
for files to be loaded into ram 
and used from there, which 
would improve speed of op- 
eration. There are several use- 
ful touches, such as the display 
of current activity during 
loading, available memory, 
| date, number of records, data- 
base file name, current Archive 
routine name, default device 
name, etc. 


Different 


Sub-menus offer options 
which are sometimes worded 
slightly differently from the 
way they are on the main menu; 
this shouldn’t cause much 
trouble, once the user has had 
some practise. 

There is some inconsistency 
in the required manner of 
(menu) input from the user. 


Machine Code 


Machine Code 
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PLANNER 


One of the most useful programs you could wish for. It will provide a printout of 
dates, with day and week numbers, in a month-per-page format from a given 
starting date and number of forward days. It also includes routines for finding 

day and week numbers you can use in your own programs, 


£10.00 


ALL PROGRAMS SUPPLIED ON TO 


Record Print of flptgqladd 43 records 


Title for 


Nane & Address List 


ntout. CAENTER“eng headin] 


=e 


Nem : 327818  DBEnn 
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Figure five: a rile ready to print to screen. 


Most of the input is in the form 
of single keypresses, but these 
sometimes have to be followed 
by ENTER, sometimes not. 
Likewise, some menus require 
the cursor to be moved by the 
cursor keys, then the Space bar 


Machine Code 


SCREENMASTER 

Screenmaster will record anything currently on screen in a 

‘squeezed’ form, and reproduce the picture in a variety of 
cinematographic-style wipes and speeds. 


to be pressed for selection of 
options, whereas others are 
content with the first letter of 
the option being pressed. Some 
flexibility is incorporated in the 
main menu by the facility to 
specify how many lines you 


32 Hunts Pond Road — Park Gate — Southampton — SO3 6QA — 0489 581056 
All Programs for 768K a 
SPEEDSORT 


The ultimate sorter! Sorts arrays of any size by given 
element number. The speed is devastating — up to 80,000 
sorts per second! 
£20.00 


ed QL with Trumpcard 


£20.00 


QLDL 
QL Disk Library allows the user to catalogue up to 3000 
program titles (around 75 disks at a time} in alphabetical order 
and cross-referenced by numbers given to the disks. No more 

searching for endless hours for that lost program. 
Machine Code 


TRANQUIL 
Tranquil converts Quill documents into BASIC PRINT 
statement form in order that they can be more easily 
manipulated for printing and adding printer instructions etc. 
Machine Code 


NCH DISKS — POSTAGE & PACKING FREE 


DBEASY 


want to move, before hitting 
the cursor key. For example, to 
move from the first line (Single 
Mode), to the last (Quit 
DBEasy/ ARCHIVE), you can 
hit 7, then down-arrow. You 
could also hit up-arrow once, 
which would be faster. 


Slow 


The program is far from ex- 
pensive, and it is clear that the 
programmer gave a lot of 
thought to what is needed to 
make Archive more approach- 
able for less-experienced users. 
It achieves its purpose of mak- 
ing Archive more user-friendly, 
and it is rather more ‘profes- 
sional’ than most other pro- 
grams inthis price and purpose 
category that I have looked at. 
The failings are mostly of a de- 
tail nature, and not such as to 
seriously mar the program for 
most users. The lack of speed 
would be a drawback for any- 
one wanting touse the program 
for work which needs to bedone 
ina hurry, butshould not prove 
a problem for the typical home 
user, with maybe a small club 
database to keep in order. 


£15.00 


£10.00 
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icture the scene: the 

soft music is on, the 

curtains are pulled, 

and the room is only . 
lit by the warm glow of your 
trusty QOL. “I'll make you a 
cocktail, darling”, youmurmur 
romantically. “What are your 
favourite drinks?” 

“Oh! I love apricot brandy, 
Dry Vermouth and gin. Can 
you make up one from that?”, 
she replies. 

You go over to your QL, al- 
ready programmed with 
Cocktails Waiter, press selection 
5, enter the ingredients and 


cabinet. 

You turn and see that you 
have a selection of eleven 
drinks... Abbey Bells, Claridge, 
Lutkins Special... no, here we 
are. You quickly mix one part 
apricot brandy, one part dry 


dash of lemon juice and four 
dashes of Grenadine. 

“It is called ‘English Rose’, 
my darling and may | say how 
appropriate it is. . .”. Clearly 
the night is made for love! 

For the less romantic, Imre 
Dominik has produced pro- 
gram providing over 400 reci- 
pes for various drinks cock- 
tails. It is implemented as a 
Runtime Archive application 
program which provides com- 
prehensive printing, viewing, 
searching and selection of 
drinks recipes. 

The instruction sheet is sim- 
ple to follow and contains all 
the necessary directions on 
how to make a backup and get 
| the program running. 
INFORMATION 


Program: QL Cocktails Waiter 
by Imre Dominik. 


Supplier: Dilwyn Jones Com- 
puting, 41 Bro Emrys, Tal-y- 
Bont, Bangor, Gwynedd. 


Price: £10.00: Extra recipe sets 
(500 in each) £5.00. Available 
on microdrive, 3.5in or 5.25in 
disk. Needs 128K expansion to 
run. 


casually takeaglassfrom your - 


Vermouth, two parts gin, one’ 


05, FITWARE FILE 


QL Cocktails 
Waiter 


Pleasure or perdition? 
John Shaw has the receipe 


a eee 


SCE ATER SHOE: § 


A few moments 
BOOTing vp you are con- 
fronted with the main menu. 
This tells you that the database 
file (mix 1) is loaded and that 
there are 410 records in the 
memory. 

In addition you also have 11 
options: 

1. Create a new list 

2. Open another file 

3. View /alter existing list 

4, Add new cocktails 

5, What can I make with. .. 

6. Describe this cocktail. . . 

7. Select by word / phrase 

8. Reset the SELECT file 

L. List all available cocktails 

P. Paper printout 

Q. Quit 


OPTION 1 allows you to cre- 
ate a new database for your 
own purposes, such as cook- 
ing recipes or details ofarecord 
collection. 


after 


OPTION 2. Other databases 
containing 3-400 recipes are 
available ata cost of £5.00 each. 
This option allows them to be 
brought into use. 

OPTION 3 is the main tool 
for displaying the list and 
moving, sorting, altering, 
finding and deleting your 
cocktails. It is a menu driven 
screen with a single keypress 
entry facility. 

OPTION 4 will allow you to 
enter new cocktails of yourown 
invention or just some you may 
have copied from a book. 


NAME KITCHEN SISK 
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WuiuR sized gloss. 


OPTION 5 is a particularly 
useful option. You can enter 
up to five ingredients which 
you have in your cocktail cabi- 
netand the program will search 
out all those recipes which 
contain the specified drinks. 
You can then either page 
through them individually on 
the screen or print them out. 
On leaving this option the file 
will have to be reset (OPTION 
8). 

OPTION 6 enables you to 
enter the name or part name of 
a cocktail and the database is 
searched. For example if you 
enter the word ‘Lady’, you will 
have 5 cocktails displayed; 
Apricot Lady, Lady Brown, 
Lady‘s Crusta, Pink Lady and 
White Lady. 

OPTION 7 allows you to se- 
lect by a word or phrase. For 
example if you wantonly those 
cocktails to be displayed which 
don‘tinvolve shaking, then you 
just choose the word ‘Stir’ and 
those cocktails will be selected 
from the rest. 

OPTION 8 is the RESET op- 
hon. 


part lemon juice 
jice, 1 san, !72 ten suger 
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i part Curacao, 2 


i tsp grenadine 
i egg white 


parts brandy 


Shake vigorously and strain into a 
medium-sized glass. 


tails per page you will need at 
least one hundred sheets of A4 
ready. 

So, here we have a very well 
written program, set on an 
adaptable database which does 
its job quickly and efficiently. 
For £10.000 it is good value for 
money. 

Finally, my wife and I de- 
cided to test the cocktail bar- 
man at our local hotel. 

“Shout out any two numbers 


my wife. 62 and 407", came her 
swift reply. 

“OK, Barman”, I said, run- 
ning my finger down the com- 
plete printout list,” My wife 
would like a. ‘Bosom 
Caresser’ and I'll have a.. . 


ree 


‘Young Man’”. 
Duck... 


“Ladies first, Ducks!”, said 
the Barman, as he leaped the 


between 1 and 410”, I said to counter. 


OPTION L will give you a 
complete list of all the cocktails 
on the database either printed 
in four column mode or dis- 
played to the screen. 

OPTION P. Here you can 
print out the whole of the cock- 
tail list, recipes and all. But be- 
ware: at the rate of four cock- 


YOUNG MAN 


3S parts brandy, I part sweet 
2 dashes of Curacac 

1 dash of Angostura bitters 
Shake well and strain into a cocktail glass. 
Serve with an olive or a cherry. 


vermouth 


ll by Tony Tebby TONY TEBBY SOFTWARE (QJUMP) 


QL SUPERTOOL Kk) 


Over 118 Commands:- Full Screen Editor, Key Define Print po eesti fa upgrade) .. 
, Last Line Recall, Altkey, |, File Handling, YES SDS SUSEREE iiaibicis 
Uaing ras fine a, i, soko TN, Hie: HN QPAC 1-Desk top accessories, calander, alarm, calculator, QPAC I! Main menu windows adjust automati- 
Default Directories, Extended Network, ‘ : - . ; f : 
16k Eprom Cartridge Version typewriter, digital Clock SYSIMION .......ecrseseseres @£21.85d cally to size. Files, directory, view, print, delete, 
; i i ; . backup, jobs, pick, Rjob, sort, channels, things 
Configurable Version on Microdrive ZITASOFT SOFTWARE by Steve Jones exec, wake, buttons, Hotkey, Hotjobs. Fully 
LOCKSMITHE copies M/ORIVE - M/DRIVE ....@£14.95c Multitasking, allows many programs to run at 
4MATTER + LOCKSMITHE copies M/DRIVE - DISC once, Requires min of 256k expanded memory 
OR Dis Weitiarieatees (rn Tiaeal SIGNS sessimissesnsicesecnissene MPU ceesassssatassinsastecsene JPET ITE aretainnnrscrconrysarcrnat satncrereanconsnaoncnic @£49.91b 
QL Centronics Printer Interface ., SIDEWINDER - High resolution printer driver prints ful} Upgrade QRAM to QPAC II return master 
QL Expanderam 512K Thrucard . screens or parts of screens from postage stamp SiZ@ tO <sr-+--r-ssetseeeeercteeeiererctesennerinee @£29.90b 
large banners. Prints sideways, invert, scale, mirror, text 
QL HARDWARE fenton sic tne = esevilecdrceatnsceere @£19.95¢ AS arth Shag Qt inane 
Single 3.5" Disc Drive & (Own PSU) .. .@£103.50a SIDEWINDER PLUS - (for expanded QL's) includes all the UGUST ISSU 
Dual 3.5" Disc Drive & (Own PSU), ,@£172.50a features of above, PLUS multiple label printing, desktop 
3.5" DS/DD Dises - 10 off ... -, @£9.20c arose he ee printer 5 a for 24 ed Bare QPOWER REGULATOR 
QL Keyboard Membrane ..... @E11.50d 5) and Jx80 colour printers. {Please state 3. oera.o de Siitch mode power supply, QL runs cool. 
QEP Ill Advanced Eprom Programmer .. 121.90d ; A ~ ‘ Stops, Lock ups (due to voltage drop) Helps 
Care Eprom Cartridges each Upgrade to Sidewinder Plus . -@EB.05C — fiiter noise out, Simple to fit (no soldering) 
ULA CHip 2X8301 HEAT TRANSFER RIBBONS & PENS 2 £24.15¢ 
SOFTWARE 87 (State MDV or Disc) Print your own T-shirt Design. Just printon paper and iron MEalabASU ELS dtel Nile BUT lor 
7 ; onto your T-shirt. Stop those sticking keys, give your key- 
} TEXT87V.300 (Requires Min 256k) ... Star LC10NX1000, Rainbow .... .@E17.25¢ board anew lease of life only........ £2.95¢ 
FOUNTED 89 .... Star LC10NX1000, Black ...... .. @E11.50¢ 
FOUNTEXT 88... Epson FX80, MX80, LX80, FX100/Okidata ML80 Citizen OPEN 


TEXT 87/FOUNTED 89/FOUNTEXT 88 120D/Star NX10, Black, Panasonic 1080/81 ... @£11.50c 9am-5pm Mon-Thu 


’ 248B PRINTER DRIVER oo. @£15.00c Smail 5 colour pen set é & Qam-4pm Fri 
| Upgrade to Text 87 V.3.00. Return old copy together with Jumbo 5 Colour Pen Set a F 
i SSoceucecodestulesanita res petaniueel aroun Guanonahas neo oameea @£25.00d 
| CARE ELECTRONICS 
RGB OL 1 Phono CEs meee lae 
é , 
Philips CM8833 Colour Med-Res ... 


RGB 8-6 pin DIN ..... @£7.13¢ 
.@£253.00a RGB 8-7 pin DIN (Hitachi @€7.13¢ GARSTON, WATFORD, 
Philips BM7502 Green Hi-Res uu. £97.76a RGB 8-7 pin DIN (Ferguson) @E£7.13¢ HERTS, WD2 6NL. 
RGB 8 pin to SCART (Euro) .... .. @£11.50c Tel: 0923-672102 
6-way PCC 25-way 'D’ (Printer-Ser 1) we @EO.89C Fax: 0923-662304 
Please add carriage 


a=£11.50 b=£3.45 


PLEASE NOTE THAT DUE TO CHANGES IN VAT ALL PRICES 
WILL BE SUBJECT TO 2.5% INCREASE 
By Post. Enclose your Cheque’/PO made payable to CARE Electronics or use ACCESS/VISA. Allow 7 days for delivery c=£1,38 d=? .30 
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| Hardware Review 


P DeskJet Printer 


With all the interest in laser printers going around, 


Dr. Peter Cranfield offers his experience with an alternative. 


hat is grey and friendly and 

spits ink? If you can’t guess 

then let me tell you: a DeskJet 

Printer from Hewlett 
Packard. The DeskJet printers represent, 
to my mind, one of the most useful types 
of printer available. They provide printed 
pages at a standard equal to that of a laser 
printer, yet cost less than some dot-matrix 
printers. For the past year I have been 
using DeskJet printers with my QL com- 
puters, and I do not know how I would 
manage without them. 

The DeskJet printers are described by 
their manufacturers as ‘Plain paper drop- 
on-demand thermal inkjet printers’. They rely 
on the principle that when water-based 
ink in a tube is rapidly heated, a drop of 
ink is ejected from the orifice of the tube. If 
a sheet of paper is near the orifice, then the 
ink will land there and make a dot on the 
paper. Hewlett Packard have refined this 
process to provide ink cartridges with 50 
small holes ina metal foil, spaced over one 
sixth of an inch - a density of 300 dots per 
inch. When this is scanned across a sheet 
of paper, dots of ink can be shot out on to 
the paper to build up images of letters and 
graphic symbols in strips of one sixth of an 
inch. The resulting image is of a resolution 
equal to a standard 300dpi laser printer, 
and may well be blacker and more even in 
appearance. 

The DeskJet printer was first introduced 
at the start of 1988. Hewlett Packard in- 
tended this to be a printer that would 
provide laser printer quality ata very low 
price. The printer was designed to accept 
up to two font cartridges which could be 
slotted into the control panel of the printer, 
and thus extend the range of typefaces 
that could be used. Alternatively, memory 
cartridges could be slotted in, and so called 
‘soft’ fonts could be downloaded from a 
floppy disc into the printer’s new memory. 

Within a few months the DeskJet was 
reduced in price and joined by a big 
brother, the DeskJet Plus printer. The 
DeskJet Plus had been given a different 
microprocessor chip for its brain, one 
which was able to address a much in- 
creased memory. This enabled the printer 
to handle a larger range of fonts, and also 
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to print in ‘landscape’ mode for certain 
typefaces. Several new Font cartridges 
were introduced, and a further memory 
cartridge of doubled size produced. These 
two printers were on sale together for just 
over a year, until in August 1990, they 
were both superseded by the DeskJet 500 
printer. The DeskJet 500 has all of the 
features of the DeskJet Plus together with 
further capabilities. It has extra fonts built 
in to its memory, can operate with an 
extended range of font cartridges, and is 
able to carry out ‘kerning’ on some of the 
proportionally spaced typefaces. Hewlett 
Packard reduced the price of the printer 
still further, and by ‘shopping around’, 
one can now purchase a DeskJet 500 for 
less than £400 + VAT. 


printer at the fronton the right, and nearby 
are two covered slots to take the font car- 
tridges. 

When you unpack your new Deskjet 
printer, you remove from the box an in- 
struction book (well, books really), an ink 
cartridge in a hermetically sealed con- 
tainer, a power supply, paper tray and 
cover, and the printer itself. The instruc- 
tion book is quite well written. It has a 
small brother with ‘READ THIS FIRST’ on 
the front cover. I suggest you do this for it 
has the printer set-up instructions inside. 

First steps include removing packaging 
and protective paper from the printer. The 
power supply module is then connected. 
This is a small box, about the size of a 
100mm cube, containing transformer and 


The DeskJet 500 with font cartridge on the lid. 


The printers take cutsheet paper only, of 
A4 size or similar, or envelopes through a 
manual envelope feed. They have a built 
in automatic cut sheet feeder, and the ‘in’ 
paper tray for this sits in the centre of the 
front of the printer. The printed sheets are 
delivered, again at the front, but ina sepa- 
rate ‘out’ tray, situated above the ‘in’ tray. 
There is a control panel on the top of the 


rectifier, to deliver power to the printer at 
20 volts from the mains supply. The lead 
from the power supply is connected to a 
socket under the base of the printer, hid- 
den in a recess. This feature allows cables 
to be plugged in without them extending 
beyond the outline of the printer. As the 
printer can therefore be placed up against 
a wall, it may take up less desk space than 
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A font cartridge print foil face. 


some smaller printers. Next to the power 
connector are two further sockets. Oneisa 
Centronics type parallel socket, the other 
is an RS232 serial type socket. Either can 
be used for connecting the printer to your 
QL, and as serial leads are cheaper, I use a 
serial lead, and connect to the ser 1 port on 
my QL. 

When the leads are connected the printer 
can be turned back the right way up. The 
paper tray can is next to be fitted. The ‘in’ 
tray is already in place, but the ‘out’ tray 
must be clipped into its place, over the ‘in’ 
tray, and then the cover can be placed on 
top. 

The next job is to fit the ink cartridge. 
This is in a hermetically sealed container 
to prevent the ink drying out. New car- 
tridges are date stamped, and spare car- 
tridges should not be kept in hot condi- 
tions. To fit the cartridge, the lid of the 
printer is opened, and the cartridge cradle 
can then be located on the right side be- 
hind the control panel. The ink cartridge 
has a tape stuck on it to protect the very 
delicate foil print head. Leading from the 
print head is a matrix of 64 electrical con- 
tacts, which have to make good electrical 
connection with small terminals in the 
cartridge cradle. The ink cartridge is 
grasped by the green coloured handle on 
the top, placed in the cradle, and pushed 
forward to “snap” into place. The lid of the 
printer is closed again, and all is ready to 
start printing. 

Paper needs to be placed in the paper 
tray. Hewlett Packard recommend good 
quality photo-copier paper as being suit- 
able for good results, but high quality 
bond or wove paper may give even better 
quality. The surface of the paper is impor- 
tant, and its ability to absorb the ink well 
enough to allow rapid drying yet not to 
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allow smudging is crucial. As the instruc- 
tion book says, trial of paper before bulk 
purchase is essential. 1 have had good 
results with photo copier paper from ‘Neat 
Ideas’ at £1.79 per ream, and excellent 
quality from Wiggins Teape’s Conqueror 
paper at about £12.00 per ream. Paper is 
placed into the ‘in’ tray, face down and 
with the upper edge of the paper into the 
printer. When the first sheet is drawn by 
the printer from the pile of paper, it is 
taken round by a large roller, upwards 
and onto the printing platen near the print 
head. The face of the paper is now up- 
permost, and the upper edge of the sheet 
is heading out of the printer towards the 
out tray. When the paper has been printed, 
the printer holds onto the sheet of paper 
forasecond orso,and thentwoarmsatthe 
side of the ‘out’ tray are raised, and the 
sheet drops onto the tray, or on to the 
previously printed sheet. This slight delay 
is to prevent smudging of the ink which 
takes a few seconds to dry. 

The printer can now be turned on. Per- 
haps it would be sensible to carry outa self 
test before any important printing is done. 
On the control panel are four large but- 
tons, and four small buttons. The large 
buttons are ‘Form Feed’, ‘Font’, ‘Mode’ 
and ‘On Line’. The row of small buttons 
consist of two for paper movement, one 
for priming the ink cartridge, and a reset 
button. 

To initiate the self test sequence, the 
‘Font’ button is pressed down, and the 
printer is turned on by the on/off switch 
situated on the front lower corner. The 
‘Font’ button is held down for a couple 
more seconds and then released. The 
printer will go into its reset routine, 
whereby the printer will make sure that 
any paper in the printer rollers is expelled, 
and the printer head will traverse the 
platen to establish its positioning. The 
printer will pause a second, and then the 
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‘Busy’ lamp will light, and the self test will 
begin. 

However, instead of the whining buzz 
of a dot-matrix printer, or the rat-a-tat-tat 
of the daisy wheel printer, there is just a 
gentle sound, a little like wet chamois 
leather upon glass. There is not even the 
hum of a cooling fan that is heard near 
laser printers. 

Assuming no extra font cartridges have 
been installed, the printer will print out | 
samples of each of the typefaces built into 
its memory. It will print out Courier in 10 
cpi, 16.7 cpi and 20 cpi. Next it will print 
Courier Italic in 10 cpi before going on to 
CG Times, and Letter Gothic. It then prints 
out on a second sheet of paper some bold 
print, underlined print, double underlined 
print and draft quality print. On a third 
sheet, it prints out Courier in three sizes in 
landscape format. 

So far so good. Now it is your chance to 
print from your QL, to produce the report 
or letter that has taken so long to type. This 
is where it may become difficult. The 
DeskJet printers all speak a computer lan- | 
guage called Hewlett Packard PCL printer 
language. Most dot matrix printers and 
most software packages for the QL com- 
municate in a language of Epson printer 
control codes. The two languages are not 
the same. When the wrong language is 
used, all that you will get is an inky mess 
at the top of one sheet of paper, and de- 
spair. How do you get round this prob- 
lem? There are two ways: firstly, you can 
buy an ‘Epson FX-80 Printer Emulation 
Cartridge’ for your printer or, secondly, 
you can make sure that all of your soft- 
ware is able to communicate in the HP | 
PCL language. 

If you purchase the Epson Emulation 
Cartridge, it is slotted into one of the font 
cartridge slots near the control panel on 
the printer. This must be done with the 
printer turned off. When the printer is 
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The DeskJet 5000 in action, producing a sample font sheet. 


39 


turned on again, a self test will reveal a 
different result. The DeskJet printer will 
now speak the Epson language, and will 
now happily print out all the normal Epson 
type faces, and will respond to all of the 
normal Epson FX codes. Documents from 
Quill, screen dumps and graphics will be 
printed out as though the printer were a 
dot matrix printer but of a very superior 
quality. 

However, although this is a very useful 
method of using your DeskJet printer, it 
will not allow you to access all of the other 
typefaces hidden inside the printer. So, for 
many applications, altering your software 
to suit the printer may be your method of 
choice. Most OL users will, of course, use 
the Quill word processor. Use of the 
install_bas programme will enable you to 
set up a printer_dat file correctly for the 
DeskJet printer. The DeskJet owner's 
manual has a section at the back with a 
summary of all of the printer commands, 
written not only in normal characters but 
also in Ascii form and Hex. From this you 
can enter into the installation program the 
codes for superscript, subscript, bold etc. 
etc. A choice can be made as to which 
typeface is to be used, and the correct code 
must be written into the preamble section 
of the printer dat. The choice of typefaces 
standard in the printer includes, Courier 
in several pitches (5, 10, 16.67 and 20) Cou- 
rier Italic (5, 10, and 20 pitch), Letter Gothic 
(12 and 24 pitch) and Letter Gothic Italic 


This is Courier 10 


This is Times Roman in 6 point size. 
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This is Helvetica Italic 10 point size. 
‘This is Garamond in 12 point size. 


This is Garamond Italic in 12 point size. 


(12 and 24 pitch). All of these are available 
intwoheights, '/sthinchand'/:2inch, bold 
or normal. Depending upon your use of 
Quill the choice of typeface will up to you. 
In theory, it is also possible to use Quill 
with the other fonts, such as CG Times, 
Times Romanand Helvetica etc. However, 
great difficulty will be experienced with 
this as Quill can not cope with such pro- 
portionally spaced typefaces. To achieve 
acceptable results with these typefaces you 
must look elsewhere. 

For the past three years, I have been 
using the really excellent text87 
wordprocessor program. You can purchase 
from Software87 a ready produced printer 
driver for the DeskJet500 which will enable 
you to produce printing of the highest 
quality. The DeskJet500 printer driver will 
give you access to all of the typefaces cur- 
rently available on the DeskJet500. For 
those people not familiar with text87 per- 
haps a few words are necessary here about 
the program. Text87 is a very fast and very 
interesting word processor. It has the abil- 
ity to be extremely flexible in its handling 
of different typefaces, character spacings, 
line feed settings, line widths etc. I started 
using text87 with a daisy wheel printer, 
having found Quill unable to handle pro- 
portionally spaced typefaces routinely. A 
lot of my documents are professional let- 
ters, reports, pamphlets and leaflets, and 
presentationis very importanttome. Text87 
allows me to produce work in propor- 


cpi 


This is Letter Gothic 12 cpi 
This is Times Roman in 12 point size. 
This is Times Roman Bold in 12 paint size. 


This is Times Roman Italic in 12 point size. 


This is 30 point. 


This is Helvetica 12 point size. 


This is Dom Casual in 18 point size. 
“Uhis td Brush tu 24 procul s¢z. 


tional spaced style, with one, two, three or 
four columns per page. 

From the DeskJet printer with the text87 
printer driver becomes work that looks 
like professional printing. Several news- 
letters have gone straight from my DeskJet 
to the print shop for offset litho printing. 
When text87 is loaded into the OL, there is 
no need for setting up all the printer codes 
and other details; you just set the param- 
eters for your document and away you go. 
Line spacing can be set in steps of '/:s0th 
inch, and line lengths set to the nearest 
mm. The DeskJet500 driver is set up to 
allow all of the built-in typefaces to be 
accessed immediately. This means that 
without the purchase of any font cartridges, 
youcan print out letters in typewriter style, 
or, using the CG Times typeface, you can 
produce work in 12 point and 6 point Ro- 
man characters, just like the printers use. 

The point size refers to the height of the 
character. 72 points represent one inch. 
Thus a 12 point character set is sized '/sth 
inch from the top of the capital letters to the 
botttom of the descenders or the lower 
case letters.) 

Alternatively, if you wish, you can go 
ahead and purchase font cartridges to ex- 
tend your range of typefaces. I find that the 
Times Roman Collection Cartridge and 
the corresponding Times Roman Head- 
lines cartridge make a very useful pair for 
general work. These contain a range of 
fonts from 6pt to 30pt. Not all of the point 
sizes have bold and italic character sets 
included in the cartridge, but this does not 
often matter, the selection provided is usu- 
ally sufficient. The Times Roman typeface 
is different from the CG Times typeface 
built into the printer, but the difference is 
probably only apparent to most viewers 
when the two typefaces are compared to- 
gether. The Helvetica cartridges also form 
a useful pair, but perhaps are not quite so 
versatile for ordinary use. The cartridges 
provided new for the DeskJet500 printer 
include the Garamond typeface, the Dom 
Casual typeface and the Brush Script 
typeface. The Garamond is a very fine 
looking serifed typeface. It is more subtle 
than the Times Roman, and is suited more 
to use in books and important presenta- 
tion work. The Dom Casual and the Brush 
are much more lighthearted in character, 
and must be used with care, as too much of 
either of these would spoil a document. 

If you wish to produce documents of the 
highest quality, comparable to those pro- 
duced on the the most advanced 
wordprocessors then I cannot do other 
than recommend text87 with the 
DeskJet500. 

However, perhaps your needs for a 
printer are not those of a wordprocessing 
workhorse. Here too the DeskJet may fit 
your requirements. ] use one of my DeskJet 
printers in my Dental Surgery, printing 
out all of the patient details on the myriad 
of different forms so kindly provided for 
us by the National Health Service. All of 
my patient database is run on a QL, and 
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whenever a patient comes for treatment, a 
form has to be completed. The trusty 
DeskJet printer sits quite happily at the 
reception desk, quietly and 
uncomplainingly printing out forms with- 
outa hiccup. In this instance, the software 
for the surgery has been written (by myself, 
but that is another article that has yet to be 
written) making use of the HP PCL lan- 
guage. For overa year this system has been 
in use, and not once has the printer given 
any trouble. Its ability to pick up pre- 
printed forms and print the data accu- 
rately in the required spaces is unques- 
tioned. In fact, the Government’s Form 
Printers are more inaccurate in their pro- 
duction of the forms than the printer is in 
its positioning of its output. Some of our 
forms are read at their destination at the 
Dental Practice Board by an Optical Char- 
acter Recognition machine. The OCR ma- 
chines are programmed to read handwrit- 
ten letters, and for some reason, known 
only to those civil servants who designed 
the forms, the character spacing required 
is 66/300 of aninch. This can be coped with 
by the DeskJet printer through careful use 
of the PCL language. The quietness of the 
printer is a boon in the environment of the 
receptionarea, and nobody has complained 
about it being a nuisance or tiring. Even 
our notepaper is printed by the DeskJet, 
thus saving us money on the printing of 
stationery. 

Here we get to the nitty gritty. If this 
printer is so wonderful, why are other 
printers still being made? Well, there are 
some disadvantages. The first one must be 
the ink. Ink cartridges cost a fair amount of 
money, and the ink smudges if it is wetted 
by water. (The author is perfectly correct. A 
small drop of tea proves the point.) The print 
quality is, however, beautiful. 

However, let us look at these points in 
turn. Firstly the cost of running the printer 
depends upon your usage. If you stick to 
normal Courier typeface, Hewlett Packard 
estimate that you will obtain about 500,000 
characters from an ink cartridge, which is 
equivalent to about 800 pages of A4 paper. 
At a cost of £14.60 + VAT this represents 
about 2p per page. If you use draft printing 
mode though, then your ink use will be 
halved. Conversely, use of more elaborate 
typefaces will increase your ink use. How- 
ever, there are some suppliers selling the 
cartridges at lower prices, and there is also 
avallable, from EQ Consultants, in Scot- 
land, a non Hewlett Packard kit for refill- 
ing the ink cartridges. ] have used the 
refilling kit, and it is certainly as good as 
the kit manufacturers claim. For a cost of 
about £60.00 you receive a box containing 
a drill, to opena hole in the cartridge, some 
special bungs to seal the cartridge after 
refilling, and a bottle of ink sufficient for 
about eleven refills. The ink in the refill kit 
isa little blacker than the standard ink, but 
is very slightly slower in drying. However, 
it works very well indeed. 

The smudging of the ink is more of a 
problem of perception than one of fact. If 
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you spill water on the printed areas, the 
ink will run. If care is taken, it is not a 
difficult problem to prevent. Hewlett 
Packard have just introduced a new for- 
mulation for their own ink which does not 
run as much as the original ink. I can 
confirm that this is a great improvement. 
However, to put the problem in perspec- 
tive, a lot of writing inks used in fountain 
pens are similarly water labile, and no- 
body worries overmuch about this. If a 
document is to be placed in an environ- 
ment where it may become splashed, then 
spray the document with an art fixative 
spray. It’s as simple as that. Alternatively, 
a good photocopy can be made. 

What other problems are there? Well, 
you cannot print in ‘landscape’ format 
unless you stick to Letter Gothic and 
Courier. This has not proveda big problem 
for me, but it could be a problem for some 
people. The only way round this is to pur- 
chase a laser printer which, with its much 
greater memory capacity, isable toachieve 
landscape format printing of proportion- 
ally spaced typefaces. However, how much 
extra will this cost you? Quite a lot, you 
will find. 


Paper size 


Thenext problemis paper size. Although 
you can feed single sheets through the 
envelope feed, you may have difficulty 
with sheets that are much smaller than A4 
size, as they are hard to keep straight. 
However, even this can be overcome by 
starting with A4 and cutting to size after 
printing. Incidentally, it is possible to feed 
light card into the printer, if it is done one 
sheet at a time. This can be very useful in 
certain circumstances. 

If youare not the sort of person who likes 
to know how things work then I suggest 
you skip this bit. If ]have not yet convinced 
you that this is the printer for you, then this 
will not help. The DeskJet printers have 
evolved over their short lifetime, and fonts 
produced for the 500 printer cannot be 
used with earlier printers. Let us look at 
some of the design features of the printers. 
The characters printed by the printer are 
stored as a bit-map in the printer’s perma- 
nent memory, in the permanent memory 
of plug-in font cartridges, or on a floppy 
disk, as ‘soft’ fonts, and are transferred to 
the volatile memory of plug in memory 
cartridges. The bit-map is similar to the 
method by which the OL stores its fonts of 
characters, but as the resolution is 300 dots 
or pixels per inch, each character uses quite 
a lot of memory. 

From the bit-map of a particular letter, 
the DeskJet works out which ink jets must 
fire at each point of the ink cartridge’s 
traverse across the page. The printer has 
routines built into its programming that 
enable it to print letters half the size ofa bit- 
map letter. Hence a 12pt letter can be 


printed as a 6pt letter by the process of 
omitting alternate dots in height and width. 
This is a slight oversimplification of the 
process that is followed by the printer, but 
‘algorithmic’ half height printing is carried 
out on most fonts. Similarly, bolding of 
letters can be carried out by the printer by 
adding an extra row, or two, of dots on the 
bit-map image of a letter. However, this is 
not always an acceptable way of produc- 
ing bold type, especially with the propor- 
tional typefaces, and some typefaces will 
have separate bit-maps for bold characters 
and for italics. Draft quality printing is 
achieved by printing a blank instead of a 
dot in alternate dot positions. 

Each character fits within a grid pattern 
or cell. The size of the cell determines 
whether the ink cartridge has to make one, 
two, three, or four passes to build up the 
complete character. The width of the 
character is defined by the cell, and will 
have a central character area, a leading 
space area, and a trailing space area. These 
space areas allow for the space between 
the letters, but may be occupied by parts of 
the letters, ie. the leading space will contain 
the descender of sloped italic characters. 
With the advent of the DeskJet500 printer, 
the ability to allow overlap of the character 
cells has been introduced. This feature has 
been called ‘kerning’ by Hewlett Packard, | 
and indeed it acts in a similar fashion to 
true kerning, but it is not variable and is 
really just the ability of some characters to 
overlap each other’s cell spaces on the 
page. However the effect in the print is 
remarkable. The Brush Script typeface has 
letters that join up beautifully, and the 
descenders of the Italic Garamond char- 
acters flow under the edges of previous 
letters. If you examine the Times Roman 
italic fonts, produced for the DeskJet Plus 
printer, the letters with descenders are 
slightly less sloping, just to prevent this 
overlap. 

Here then is the printer of the nineties. If 
you require a robust printer at moderate 
cost, that will provide you with results 
which will make you proud to have pro- 
duced them, then take a look at the DeskJet 
printer. It is small enough to fit in your 
home or office, is quietand convenient. No 
wonder Hewlett Packard are proud of it. 
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Like SET, ALTER expects two param- 
eters: a value, and a corresponding name 
that will be used to identify the value in 
future. The type of the name is determined 
by the last character, as usual. Integer 
values -32768 to 32767 end with a per 
cent sign, while a final dollar sign denotes 
a string of text up to 32K long. Other 
values are held in 44 bit Qdos floating 
point form. 

Thus Northern readers might SET 
NOWT to 0, SET NOWT TO." and SET 
NOWT% to NOWT. | gave many more 
general examples last month. Values are 
coerced to match the name; it is worth 
using integer values when appropriate, so 
that the computer does not have to con- 

' : : . vert them whenever they are fetched. 
Simon N Goodwin extends his SET routines to allow There is an important difference be- 


Resident Variables that are shared by SuperBasictasks, fwgenthesyiiaxo’ GET and ALTER. The 
and impervious to CLEAR and NEW commands. 


he DIY Toolkit command SET 
creates resident entries in the # BL WORLD DIY TOOLKIT - SET, SET# & ALTER extensions - RESIDENT VARIABLES 
SuperBasic Name Table, so that * Version 1.64, Copyright 1991 Siaon N Goodwin, suggested by Luca Pivato. 
stored values of any type can be ; 
accessed by all subsequent Basic tasks. ae : 
| have now developed the SET routine, dnp Size y Shad oe ese froa Cosson Heap 
introduced in April, so that tasks can AL- call _cade 133 6B0%K OP or JSR «L 
TER shared values as well as read them. string SuperRASIC type code of a string 
This month's listings extend the idea of #} oat Type code for floating-point values 
Resident Constants to encompass Resi- integer 16 bit signed integer type code 
dent Variables, building on the code and 7 
epts introduced last month. If stuck 5 : 
eos thebbeak ae from the mh start define,al Point to the table of details 
lisher, or text and programs together on $110\n, a2 Find BP. INIT (a word vector) 
disk. j faz} Add SET to SuperBASIC 
Once a SuperBasic program has SET t 
the values of Resident Variables they . : ’ 
remain available to all Basic tasks until # Internal variables, not for ROM: could be made a GFAC or Argos THING 
you re-set the machine. Later any 
SuperBasic program can read the value heap luap dc.w luap size SET memory allocation size, 16-32740 
just like any QL variable or function, or sentinel dec. Q Heap pointer (NOT suited to ROM!) 
ALTER the value accessible to other tasks. ri 
Thus concurrent or sequential Turbo, . 
Supercharged and QLiberated tasks can FESR AGE aiveh ee Extra space Reeted ; 
communicate rapidly with SuperBasic(s), bsr.s ¢ ecker Allocate room on the stack 
and one another, using resident constants move. (a7) +,a0 AQ -> Result 
and variables just like ‘toolkit’ functions. move.w {ah Olal,ad.}i = Fetch and stack the result 


moveq #integer,d4 Indicate INT result 


Chaining : rts Return DG set by CHECKER 


in byegone times QL users dreamt up read ptr moveq #4, d! Extra space needed 
devious ways of ‘chaining’ programs and bsr.s checker 
passing data between tasks. Some poked move.]  (a7it,a0 AO ~> Result 
babisacd peg ui ails cipal aove.w (a0) ,d3 Checked for even-ness earlier 
roblems — others used slow temporary 
files, or pipes. SET and ALTER are supe- me sabi Eran Bey ae one! 
rior to those methods; they are more com- trap HH 7 Find the svstea variables 
patible, fasterand much easier to program. move.} (a0, d3.#),d2 Read the system vector 
| wish | had written them years ago. aove.] d2,di Di will be the exponent 

ALTER extends the code of SET. The beq.5 normalised Job done, if D2 & Di=0; result 
new version dynamically allocates memory slaw loop move.w #2080,d! Guess at the exponent + | 


ings ina ‘pool’ all ‘ 
nll Ieee see leap normaloop subq.w #1,d1 Halve the weight of the guess 


if the pool is split into several sections; it add.1 d2,d2 Double the mantissa 

| has been designed to make it easy to bol.5 normaloop Does it still fit? 
avoid problems of memory fragmenta- Isr.) 1,4? Whoops, ensure sign=0 (+ve) 
tion. : i : 
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quoted name, with no previous value, 
whereas ALTER expects the name of a 
previously SET value, in quotes or in- 
verted commas. 

Presume we have SET PRINTER TO 
‘SER’, and want to re-direct programs to 
use a remote printer on another network 
station, by changing the value of PRINTER 
to 'N1_PARC’. We cannot simply type 
ALTER PRINTER to ‘N1_ PARC’, be- 
cause SuperBasic will pass the value of 
PRINTER$ rather than its name to the 
routine that performs ALTER. The result 
is an ‘in use’ error if the name “SER” exists 
but has not been SET, and ‘not found’ if 
the name is not in the SuperBasic Name 
Table. 

‘Bad parameter’ has its usual meanings, 
while ‘error in expression’ signals that the 
type of aname does not match the type of 
the second parameter, asin SET NOWT% 
TO “". The separator is not checked, so 
you can use a comma instead of TO, as 
with other QL commands like COPY and 
| CONNECT. 

If SuperBasic finds a function name as 
a parameter, it calls the function and 
passes on the result, rather than the name 
of the function. If you enter SET P1 TO 3 
the code for SET is passed two floating 
point values — 3.141593 and 3.0 — with no 
way of knowing the name from which the 
first value came. It reports ‘not found’, as 
3.141593 is not a valid SuperBasic Name. 


Familiar 


You may already be familiar with this 
behaviour. Names that have no value can 
be used without quotes to identify files 
and devices, but you must put the name in 
quotes or inverted commas if you want it 
taken literally. LOAD Pl is no good unless 
you're looking for a file called ‘3.141593’. 

LOAD “It” or LOAD ‘iT’ will load the file 
called IT, even if your program includes a 
variable or function called IT, or you have 
previously SET IT. Hopefully you will 
choose aname thatis a better reminder of 
its meaning; you are allowed up to 255 
underscores or alphanumeric characters 
in any SuperBasic name. The text is only 
stored once, so long names do not slow 
down programs. 

SET needs a name parameter but AL- 
TER expects a string expression. ALTER 
“PRINTER$" to ‘N1_PARC’ works as ex- 
pected, changing the value of the resident 
variable PRINTER$. The case of letters is 
not significant, so ALTER ‘Printer$’ to “N1 
PARC” is just as good. 

The use of quoted names means that 
ALTER works as well from compiled tasks 
as it does from Basic. ALTER suspends 
multi-tasking momentarily while values 
are changed, so that tasks accessing the 
resident value do not end up with a mix- 
ture of the old and new values! 

ALTER is not as fast as SET, because 
it needs to look through the SuperBasic 


Sinclair/QL World May 1991 


nor@alised move. 
agve, | 
moveg 
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Transfer @antissa 
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AY. CHRIX checks space 
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* Make A4 -} SuperBASIC (task 0,0) for Master Name Table access, etc. 
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move. | 
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bai.s 


lookup 


Search entire task tree 
Look far SuperBASIC 
MT.WINF Trap key 

AQ i= base of task 0,0 


Is this ALTER? 
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Name List to find each name. This slows 
down changes to resident variables, but 
the values are accessed as fast as ever 
once they have been assigned. The same 
fast routines are used, whether the value 
was SET or ALTERed. 

The parameters of ALTER may be ex- 
pressions, and may include calls to other 
resident functions. You could use SET 
SCORE to 0 and follow it with ALTER 
“SCORE” to SCORE+1, or ALTER “ME$” 
TO ME$ & “Dip. Phil". You could SET 
THIS$ to “THAT$", SET “THAT$" TO 
THIS$, and later ALTER THIS$ TO “”, 
changing the value of THAT$, rather than 
THIS$. 

Resident variables and constants are 
powerful extensions to QL and Thor sys- 
tems, but this Toolkit volume has an extra 
purpose. It illustrates the memory-man- 
agement facilities built into Qdos. These 
are simple and easily overlooked, but they 
embody fundamental algorithms that are 
both interesting and useful. 


Dynamic 


‘Heaps’ form the basic data-structures 
of Qdos, Argos and SuperBasic. SET and 
ALTER use them to build a new dynamic 
and persistent environment outside 
SuperBasic. The User Heap makes these 
extensions much superior to the ‘environ- 
ment variables’ of PCDos or ‘core com- 
mon’ in old minicomputer systems. 

All Resident values are held in the User 
Heap. Integer and Float entries use a 16 
byte heap entry. Resident strings use be- 
tween 24 and 32,792 bytes, depending on 
the text length. Heap allocation sizes are 
rounded up in steps of eight bytes. 

A SET integer uses 12 out of the 16 
bytes allocated to it it the heap. The first 


long word is the length, invariably 16. The - 


SuperBasic Name Table vector for the 
name points to the code in the next six 
bytes — a JSR to the READ_INT routine, 
which picks up the integer data value in the 
two bytes immediately after the long jump 
destination address. The last four bytes 
are un-used. 

Floating-point values are held in much 
the same way, but the word is the expo- 
nent of the value and the spare bytes hold 
the long word mantissa. SET# stores an 
integer and uses it as an offset to extract a 
long word from the System Variables. 

Resident strings are held in two sec- 
tions, rather like arrays and their descriptors 
inside SuperBasic. The first ten bytes hold 
the length and the code, followed by along 
word address, which points to the string 
value, 

When a Resident string is SET the value 
gets put into the heap space straight after 
the code, but if you ALTER the string value 
so it won't fit, my code jettisons the old 
value space and allocates a new space 
elsewhere in the User Heap. 

If you extend a string value and overflow 
the space reserved, ALTER splits the 
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+ 
moveq 
lock_case and.b 
addg.} 
subq.# 
bne.s 
* 


#-33,d2 
d2,24al,ad.1) 
#i,al 

#1, d0 
lock_case 


Conversion aask = NOT $20 


Advance through text 
Count down length 
Convert all characters 


# Work out the datatype to be SET from the name text, if need be 


t 
tst.b 
beq.s 

move. b 
aoveq 
cap.b 
beq.s 
moved 
cap. b 
beq.5 
eoveg 
t 


d3 

type_cast 
L{at,ab.1),d3 
#string,d3 
#'$'-32,.03 
type cast 
finteger,d5 
#2? -32,d3 
type_cast 
#float,d5 


Do we need the type of parameter 1? 
No, it’s a float-type SET # comaand 
Bet the last character of the nane 
Assume a string, to begin with 

Did the name end with a dollar? 
Yes, it’s a string 

Maybe an integer, then? 

Did it end with a per cent sign? 
It’s an integer 

Other last characters denote float: 


# Now try to find the name text in the SuperBASIC Nawe List 


t 

type_cast trap 
nove. | 
move. | 
aove.} 

¢ 

next_nage @ove.w 
adda. 
cap.b 
beq.s 

advance_nl addq.] 
cap. l 
bhi.s 
acveg 
bra 


#0 

24{a4).a0 
28424), d0 
324a4),d3 


2(a0,a4.1),a3 
d3.a3 
O(a3,a4.1),d1 
got_length 
#8, a0 

ab, dG 

next nase 
#-7,d0 

super stop 


Pre-eapt disturbances 
AQ -> Name Table Start 
DO -> Nase Table End 
D3 -} Name List Start 


A3.L is offset in NL 
{A3,A4.L) -> Name 
Compare length 
Length matches! 
Advance through NL 
Stop at the end 


Not found ‘vet) 
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t 


+ Check the nawe to see if it matches the paragseter 


# 
got_length move.b {fa3,a4.1),04 
and.b = d2,d4 
cop.b Ofad,ab.1),04 
bne.s — advance_nl 
move.w = di,dé 
cubq.w = #2,dé 
bai.s found it 
aove.l  ad,al 
check name move.b = 24a3,a4.1),d4 
and.b = 2,44 
addg.} = #4,a3 
addg.l = #1, a1 
cap.b  Ofal,ab.}),¢4 
dbne dé, check_nage 
bne.s = advance_nl 
found it cap.b #9, 0fa0,a4.1) 
beg.s lookup_ok 
in_use aoveg  4-9,d0 
bra super stop 
t 
lookup ok andi 4$DOFF . sr 
aove.l d7,a3 
lea. Biad).ao 
aove.l afd? 
bra.s gat_nase 
t 
bad_param moveq  #-15,d0 
bad exit rts 
t 
notyetset move.w 2(a3,ad.}),d7 
ble.s  bad_paras 
ext.) d 
Isl.) 43,07 
add] 2Alabi,d? 
next _paraa addqg.} 4#8,a3 
t 


Ensure consistent case 


Mismatch, try another 
Save residual Jength 
DEBRA count the rest 
Found nase, length | 

D4 & Al are teaporaries 


Convert case of nape 
Step through Name List 
Step through paraaeter 


Name alsmatch, go on 


It’s already a resident FN, hurrah 
Report that the name is ’in use’ 


User made re-starts the scheduler 
D7 paints past parageter | 

Now AS & AS bracket parameter 7 
07 is the offset af the NT entry 


ERR. BF report code 

Return error code in DO 
Get parameter name NT index 
Scale for 8 byte NT entries 


Add offset from Basic base to NT 
Advance te the next parameter 


# AY -> SuperBasic, AS & AS -> Parameter #2, D7 is Basic NT entry offset 
# Evaluate parameter 23 05.8 is the data-type, 1-3. or 0 for a ’vector’ 


f 
qot_ nage oand.b |= #15,05 
aove.b 5,d4 
bne.s — not_vector 
hoveq 
not_vector ext. 
add.w 
suba.! F 
suba.w d4,a0 
movea.w $11B(a0),a0 
jor (aM) 
bne.s  bad_exit 
# 
# Is it a pre-existing function? 
t 
tst.b = (a4, d7.1) 
beq.s neophyte 
move.) 41a4,d7,1),a0 


Isolate docusented data-type bits 
Make a temporary copy of the type 
Type 0 in D4/5 means it’s a vector 
Integer parameters suit SET # 
Type Word := 1,2, 3 

Now type code is 2, 4 or 6.W 
Clear AO the quick way 

Remeaber the implicit EXT.L 

Pick up a vector: $116\114\112? 
Put paraaeter value on stack 


Has the name got a value yet? 
Naae types 0 & 9 are possible 
AO is the code vector 


DIY TOOLKIT 


string into two heap entries: the code re- 
mains un-moved, in the first 16 bytes of the 
SET allocation, along with the value pointer, 
so there's no need to update the Name 
Table. 

The place where the old value used to be 
stored is released and may be used to 
record later SET data or ALTERed text. A 
new User Heap entry holds the replace- 
ment value, and the remains of the first 
entry are updated to point at the new value. 


Free space 


If the code runs out of free space it 
allocates more and links it into the User 
Heap. You can set the default size of 
‘lumps’ taken from the Common Heap. If 
the default lump-size is too small, SET and 
ALTER add it on to the string length to find 
a space that will definitely be big enough, | 
with the usual room for expansion. 

In April | explained the merit of putting 
the little bits ina User Heap, rather than as 
individual Common Heap entries like 
ALTKEYs. The extra code is well worth- 
while. It keeps overall system perform- 
ance up, even if you have hundreds of 
resident variables or constants. 

Memory can become scarce if you in- 
tend to SET long strings; you may need to 
configure your files or design your BOOT 
program to avoid loss of memory due to 
‘fragmentation’. Particular care has been 
taken to control such problems. 


Common heap 


SET draws its space from the Common 
Heap, used for channels, buffers, and all 
kinds of temporary and permanent stor- 
age. It you get part-way through a session, 
with ram disks formatted and other stuff in 
use on the heap, you probably don’t want 
your memory divided up when along string 
is SET or ALTERed. SET and ALTER can 
use memory anywhere in the QL map, but 
ill-timed allocations may split the large 
contiguous area that Qdos needs for tasks 
and Basic. 

One option is to increase the lump-size, 
so that you lose all that you will need at the 
beginning; note that this utility does not 
allocate a lump from the Common Heap 
until the first name is SET. This option is 
bestif you know the maximum total amount 
of data you will need to handle. The lump- 
size, 16 to 32760 bytes, is a word value 
stored in the 15th and 16th bytes of the 
CODE file. Remember to allow space for 
code as well as data. 

Alternatively you can pre-extend strings, 
using SET TO FILL§ to allocates the maxi- 
mum space you might need later. This 
works like DIM in Basic; it records the 
maximum space, and pre-allocates it. SET 
BUFFER$ TO FILL (“”, 512) ensures from 
the start that there is always room for 512 
bytes in BUFFER$. You can ALTER it to 
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any smaller value, and the extra will be 
held in reserve in case the length goes up 
again. 

If you leave SET and ALTER to their 
own devices they use true dynamic alloca- 
tion, just like the interpreter. The snag of 
this is that you may end up using sub- 
stantially more space than with either of 
the apparently more ‘wasteful’ options. 
There is a tendency for useless lumps of 
empty space to become scattered through 
the memory as arbitrary areas are used 
and discarded. 


Allocation 


In practice dynamic allocation suits AL- 
TER quite well, thanks to the memory re- 
use scheme, which minimises moves, and 
the packing of data inside the User Heap. 
Sizes are rounded up onto eight byte 
boundaries so small changes in size usu- 
ally fit the space allocated, rather than 
result in the allocation or release of tiny 
spaces which will be fiddly to keep track of 
and unlikely to be useful later. 

The programis listed intwo forms. Listing 
one is the assembly code, tested using 
HiSoft’s DevPac. You may edit and re- 
assemble this with your own assembler. 

Listing two is the usual hex-loader, with 
760 bytes of DATa from line 590 onwards. 
Enter and RUN this program to create a file 
containing the ALTER code, then load it 
into ram like this: 


X=RESPR (760} 
LBYTES FLP1_ALTER_CODE, X 
CALL X: NEW 


The NEW is not necessary on JS and 
MG Roms. Once the code is loaded you 
can SET and ALTER your own Resident 
Constants and Variables, which will persist 
until you reset the computer, or discard 
them with a utility like FORGET from DIY 
Toolkit's Volume B. 


Explorer 


Listing three is the User Heap explorer, 
tested with JS or MG roms. It lists all the 
addresses and sizes of free and used 
spaces in the User Heap, but assumes that 
there’s only one lump — otherwise it goes 
on listing the rest of the Common Heap 
when it fails to find the end of the User One. 

The DIY disk version includes a variant 
of Phil Spink's Common Heap lister which 
uses SET# vectors to explore the Common 
Heap. This explicitly identifies the SET 
heap by size, purpose and owner, showing 
its position amongst other lumps of space 
allocated by tasks and devices. 

If you-have AH or JM roms you must 
type in the commands to load SET_CORE 
(line 170) before loading the rest of Listing 


three. The DIY disk version uses QUEUE% 


cap. W 
bre.s 
cap. b 
bhe.s 
t 


Wcall_code. (a+ Is it one of wine (probably!) 


bad_paraa 
¥1,45 
old scalar 


Only change FNs that start right 
Re-defining a preset string? 


* It’s a string} deallocate and re-allocate space IF NECESSARY... 


t 
leat 
nove, 1 
nove. 1 
subq.] 
CRp.W 
bec. s 

P's 


4(aQ) ad 
(a3), ad 
-4(a0) dl 
#h.dt 
Olal,ad.}).d) 
str_fits 


Make AS point at the data handle 
Find the current data area 

Find gaxiaum space for text here 
Ignore both .L & .W prefixes 
Will the altered text fit inside? 


# De-allocate the old space and find some anew 


t 
trap 
Rove.W 
addgq.1 
save. | 
subq. | 
jea.l 
MOVE. W 
isr 
novedq 
aoveg 
move.) 
bra.s 
+ 
str fits move 
add.w 
Isr.w 
bra.s 
PY 


#0 
#15,-8(a3) 
#6,di 
a3, d7 
#4,a0 
sentinel,al 
$DA\w,a2 
(a2) 

41i,dt 
#-1,05 
$38iad).al 
new string 


#1,d4 
Ofal,aé.1).d4 
43,04 

re_set 


Prevent scheduling of other tasks 
Shrink the descriptor 

Don’t forget room for the lengths 
Preserve address of the data pointer 
Step back to heap bieck length 
Release to ay heap sentinel! 

Get MM.LNKFR vector 

Release it! 

An add byte, to get the size started 
Special type for ALTERed strings 
Find the parameter stack again 

Store the ALTERed text 


Allow for an odd byte length 


Count words for DRRA 


+ Plug the new value into the scalar slot... 


+ 

old scalar addq.] 
noveg 
cap.b 
beq.s 
moved 
trap 
bra 


re_set 


+ 
neophyte trap 
no release moveg 
cap.b 
beq.s 
capb 
beq.s 
noveq 
bra.s 
# 
new string addg.] 
add.w 
move. | 
Tea. 
eave. 
isr 


space set 
alloc_dl 


44, 
42, d4 
#loat.di 


data store 


#0 

#16,di 
#string,d5 
new string 
#float,d5 
space_set 
#12,d1 
space set 


#4,d1 
Otal,ad.t), di 
di,d4 
sentine!, a0 
$D8\w.a2 

(a2) 


Skip the code address (check it?) 
Presused length 3 words for DBRA 
is it a float? 


No, just an integer 
Stop over-eager tasks @isreading 


Prevent multi-tasking temporarily 
Size = A(LEN) + StIMP) + O?{DATA) 
Strings have special requireaents 


Floating point? (6 bytes DATA) 
Yes, D1 was guessed right 
No, integer, Di should be 4+4+2 


Allow for string spacer & long header 
Still works if total overflows 32K 
Save the required size for later 
Find the start of the user heap 

Get MM.ALLOC vector 

Find Dl bytes 
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tst.1 0 

beg.s count_up 
# 
# Find aore room for data in ay heaps 
% 
find aore ave.w 
aove.! 
cap.) 
bhi.s 
moved 
add.) 


heap_lusp, ad 
d4.dt 

a0,d1 
get_plenty 
#0.d1 

aQ,di 
moveg 40,d2 
moveg  #24,d0 
trap #1 

tst.l dd 

bne super stop 
wmoveg #14, d2 

sub. | d2.¢1 

lea! sentinel ,al 
move.w = $DA\w, a2 
jsr {a2) 

aove.) d4,di 
bra.s  alloc_dl 


get_plenty 


t 


N.B. Explicit test NECESSARY here 
Set them, if they were found 


clobbers DQ-3, AQ-3 


lmplicitly EXT.L AG 

Di is space required 

Will it fit the next lump? 
Tf not, get room PLUS a luap 
No extra needed... 

Find the space needed 

Get RAM owned by SuperBASIC 
Set NT.ALCHP trap key 

Ask for Common Heap space 
Did we get it? 


Forget the 14 byte ALCHP header 
DI is the size of the available spac 


Get MM.LNKFR vector 

Link the new space inte the heap 
Reaeaber what we originally wanted 
Go back for it c 


# Count data words to be copied from RI stack to my heap, and ake code 


+ 
bad_vector moveq 
bra.s 


#-15,.d0 
super _stop 
t 

aake ptr = btst 
bne.s 
lea. 


bra.s 


#0, 1(al,ad.2) 
bad_vector 
read ptr,az 
ward count 

# 

gake nurs lea. 
cap. 
beq.s 
lea. 
bra.s 


read int.a2 
#integer,d5 
word count 
read float,a2. 
word count 

t 
count up move.l  $58lad),al 
tst.b 9d 

bp].5 make code 
move.l d/.az 
addg.] #4, a8 
move.) ad, fa2) 
Isrew 41,04 
subq.1  #3,d4 
bra.s data store 
‘ 

aake code cap.b 
bcs. 
bhi.s 
lea. 
sub.w 
Isr. 
subq. i 


tstring, dd 

aake ptr 

fake nues 

read str.a2 
> #9.d4 

#1,d4 

#5. 44 


word count 


# 


Reject odd vector paraeter values 


Check it’s an even word! 


Point to integer code 

Kut is it an integer? 
Phew... 

No, FLOAT is Hobson’s choice 


Find the parameter stack again 
Identify revived strings now 

Create the code for a new nage 

A2 -)> code handle to string text 
Step past the extension entry length 
Nake the handle paint at the new tex 
Prepare to count in words 

Discard 2 prefix words & 1 for DBRA 


Check the data-tvpe 

If less than one presuae 0, VECTOR 
It’s higher than 1, FLOAT or INTEGER 
Paint to string-fetching code 

Round wp & forget extra string data 
Count words not bytes 

Discount 5 prefix words + | for DBRA 
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to do this automaticaly. Old Sinclair roms 
do not let you use toolkit procedures or 
functions unless the extension code was 
loaded before any attempt to use that name 
in a current program line or command. 
SHOW_HEAP uses two resident con- 
stants, SENTINEL and HEAP_START. 
Both of these are derived from xX, the 
address where the code is loaded. SENTI- 
NEL is SET TO X+12 — the offset of the 
sentinel pointer after the start of the SET or 
ALTER code. HEAP_START should be 
set immediately after SENTINEL. It holds 
the address of the first entry in the User 


Heap. 


Unusued 


Just after SENTINEL is SET, the long 
word value it addresses holds the ‘offset’ or 
relative pointer of the unused space in the 
User Heap. At this stage only the first 16 
bytes will be allocated, to SENTINEL itself, 
and the free space will come immediately 
thereafter. 

The function FREE HEAP uses a similar 
technique to find the size of the first free 
space available in the User Heap. It does 
not necessarily find the largest space, as 
free memory is kept in a list in order of 
address. 

Listing one follows the usual format, 
except for one QL Devpac quirk: | have 
specified word sizes for the Qdos vectors 
with \W. Other assemblers expect 
MOVE.W $110.W, A2, rather than the 
backslash favoured by Hisoft. This compli- 
cation saves a few bytes of code, and 
means that | can rely on fixed offsets of 10 
and 12 bytes from the start of the code to 
the HEAP_LUMP and SENTINEL vari- 
ables. 


Encoded 


In that example the first .W indicates that 
word value is to be read from memory into 
register A2. The second .W indicates that 
the address $110.W is to be encoded as a 
word, -32768 to 32766; Motorola won't let 
us read words from old addresses. The 
vector word is automatically extended to 
32 bits by the transfer to the address reg- 
ister; this implicit EXT.L takes the 68008 an 
extra 267 nanoseconds. 

The value-fetchers locate their data us- 
ing the address put onto the stack by the 
JSR instruction. This code is re-entrant, so 
that any number of tasks can call the code 
at the same time. AREAD_# routine might 
be used by several tasks at once, or in 
succession, to fetch the same or different 
values. 

The Qdos scheduler might suspend one 
task as itwas running READ_STR, andrun | 
another task through the same code. This 
works fine, as the READers are not self- 
modifying and lack internal data areas. 
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The things that decide the resultant value 


are held in registers and on the A7 stack, make value @ove.] (a0) +,d! Recal] the total heap block length 

maintained separately for each task. gove.! a0, $ia4,d7.1) Set 4 Task 9 Name Table code pointer 
READ_PTR uses a simple loop to nor- move. cal] _code.{a0)+ Store a JSR.L instruction 

malise address values, shifting one bit aove.} az. taGit Store the address of the data fetcher 

position at atime. The binary NORMALISE acve.w 990700, 0(ad,d7.1} Mark this Name as a Resident Function 


routine | have listed before is faster, but subg.b  #string. dS Is this a string? 
more complicated. The disk version in- bne.s data store If not, we have alaost finished 
cludes yet another variant, optimised for lea] 14a) a2 Find address af string (4¢2+4 lateri 
some common Qdos pointer values. move.) a2, (abi+ Put it after the call 

SET itself is not re-entrant as it contains addg.} = #Z,a0 Skip ta the next user heap black 
internal data, the user heap pointer, which moveq = 816. d2 Size af the first part 


might be modified by several tasks. The sub.]  d2,ds Pt is size of the remaining part 
code takes care to avoid muddles by move.) di, faG}+ Store the block size of part 2 
switching multi-tasking on and off at crucial data_store move.w Giat,ad.1},(a)+ Copy data words to ay heae 
moments. You must put the pointer at a addg.l 42, a! Advance up this task’s RI stack 
known ram address and re-assemble the dbra d4,data_store Count the data word(s) 
code if you want to run it from eprom. super stop andi 4$D8FF , sr Return to aulti-tasking user aode 
The first part of SET puts the first param- rts 
eter type, or 0 for a system pointer, into * 
D5.B. A corresponding second parameter define =o de.w 2 Two procedures 
is evaluated onto the (A1, A6) stack, and dcew = set-# 
(A4, D7) points at the relevant SuperBasic dcob = 3, SET" 
Name Table entry. dew —alter-# 
The code labelled LOOKUP resembles de-b 5, ALTER’ 


that of the name LOOKUP% function from dc.w 6.0,0 End of Frocs: no Functions (yet!) 
September 1990, but it converts names to 
CAPITALS for consistent checking, and end 
rejects names that do not correspond to a 
SET value. 

This check assumes that only SET code 
will start with a JSR.L instruction; these 
never appear in conventional relocatable 
extension code. You should not try to AL- 
TER names that have never been SET. 
‘Bad parameter’ or ‘in use’ reports are the 
most likely result. 

The code that manages the User Heapis 
executed in Supervisor mode, so that other 
tasks cannot interrupt before it has fin- 
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100 REMark Sinclair QL World HEX LOADER v 3 

110 REMark by Marcus Jeffery & Simon N Goodwin 
Teo = 

150 CLS: RESTORE : READ space: start=RESPR( space) 
160 PRINT “Loading Hex..." : HEX_LOAD start 


‘ : fe eae ie F 170 INPUT "Save to file...";f% 
ished. This feature is vital if the code is Ce 
extended to allow variables which can be nen SEYTES PMs RE EM °5 TIE 


200 DEFine FuNction DECIMAL(x) 

210 RETurn CODE(h$(x) }-48-7*(h$(x)>"9") 
220 END DEFine DECIMAL 

230 : 

240 DEFine PROCedure HEX_LOAD(start) 
290 byte = 0 : checksum = O 

300 REPeat load_hex_digits 

310 READ hs 

320 IF hg$="*" : EXIT load_hex_digits 
330 IF LEN(h#) MOD 2 

340 PRINT"Odd number of hex digits in: ";h$ 
350 STOP 


changed by any task. There is no such 
requirement when datais being read, so this 
should not disturb multi-tasking unduly. 

Remember thatthe stack pointer changes 
when Supervisor mode is selected by TRAP 
#0; RTS will not return to the caller unless 
we revert to user mode with ANDI $D8FF, 
SR first. 

You only need to call two new system 
vectors to manage a User Heap. MM. 
LNKFR releases space, MM.ALLOC ailo- 
cates it. Note that the two calls use different 
registers to address the sentinel. Basic 
routines that use the heap often to re-load 
Ai from the Sytem Variable BV.RIP, as its 
value is clobbered by the Heap routines. 

Don't be tempted by Manager Trap #1 
routines MT. ALLOC or MT. LNKFR. These 
custom versions for the SuperBasic inter- 
preter suspend multi-tasking and use fid- 
dly A6-relative pointers. They were tacked 
onto Qdos 1.00, the FB rom, replacing the 
Supervisor traps MT. SUPVS and 
MT.SUPEX of version 0.08, the last ‘pre- 
release’ Qdos. 

From NORELEASE onwards SET finds 
| room for the new value and associated 
code in the User Heap, generates an ap- 
propriate amount of code, and sets the 
Name Table entry directly. This is not the 


370 FOR b 1 TO LEN(hs%) STEP 2 

380 hb DECIMAL{b) : 1b = DECIMAL(b+1) 

3380 IF hb<O OR hb>?15 OR 1b<0O OR 16b>15 

400 PRINT" Tllegal hex digit in: “j;ht : STOP 
420 END IF 

430 POKE start+byte, 16*hb+1Lb 

440 checksum = checksum + 16*hb + 1b 

450 byte = byte + 1 

460 END FOR b 

470 END REPeat load_hex digits 

480 READ check 

490 IF check <> checksum 

500 PRINT"Checksum incorrect. Recheck data.":STOP 
520 END IF 

530 PRINT"Checksum correct, data entered at: "j;start 
560 END DEFine HEX_LOAD 

576 = 

580 REMark Space requirements for the machine code 
590 DATA 760 


Woo 
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610 REMark Machine code data 
620 DATA "43FA02E034780110" 
630 DATA "%202616A2Z205F3390" 
640 DATA "615C205F36107000" 
650 DATA "670C323C08205341" 
660 DATA "EBE8002382E8027802" 
670 DATA “3398E8002390E802" 
680 DATA "7203D25008810000" 
690 DATA "3598E800548A51CC" 
700 DATA "4A2E00546B063278" 
710 DATA "“93C42D4900587000" 
720 DATA “49EBO0010BBCCE6624" 
730 DATA "“28484AS856B1A1A33" 
740 DATA “67027A001233E800". 
750 DATA "“4BEBOOO82EOD3078" 
760 DATA “E8006 7ESB32004BE9"., 
770 DATA “S5S289534066F64A05" 
780 DATA “B6E3CO004670A7A03" 
790 DATA "4E40206C0018202C" 
BOO DATA “C8O2D7C3B233C800" 
810 DATA "“7OF9600001A81833" 
B20 DATA "“66E83C0155466B16" 
830 DATA “528B5289B831E800" 
840 DATA “O009C800670670F7 " 
850 DATA “26474BEB0O0082E08" 
860 DATA "“E8026FF648C7E79F" 
870 DATA "OOOF180566027803" 
880 DATA "306801184E9066D4" 
890 DATA "“78040C584EB966C2" 
900 DATA “O00420532228FFFC", 
910 DATA "4E40377COO1LOFFFS" 
920 DATA "FE2C347800DA4E92" 
930 DATA "60307801D871E800" 
940 DATA "“BA3CO00267027800" 
950 DATA "721OBA3SCOO001670A" 
960 DATA "60065C81D271E800"., 
970 DATA "“OODSB4E924A80674E" 
980 DATA "62027200D2887400" 
990 DATA "008C7410928243FA" 
1000 DATA "220460C670F16074" 
1010 DATA 
1020 DATA 
1030 DATA 
1040 DATA 
1050 DATA 
1060 DATA 
1070 DATA 
1080 DATA 
1090 DATA 


“45FPAPDC86024226E”" 
“5B882488E24C5784 
“62D445FAFPDB80444" 
"“2988780430FC4EB9" 
"“5SO05660E45E8000A 
“2ZOC1I30F1LE8005489" 
“4B? 50002FDBA0353" 


“4A BFAFPDAC6O3445FA", 


"4552000000000000", 
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“4EDZ03F000000000" 
“E80078034E757206" 
“4841243030002202" 
"“D4826AFPAE28A3381" 
“4Bh7572066130205F" 
“78024E75205F2050" 
“68114E24053442449" 


-"FFFS78014E752801i" 


“O11A4E91226E0058" 
“4E757AFF60027A01" 
"740072007 0024E41" 
“E80167 1008050007" 
“670000B47 0F14E75" 
“O1164E9066F03031" 
“00027 4DFC531E802" 
“67161631E8017A01" 
“B63CO00567027A02" 
“001C262C00203670" 
“670C5088BO8862EE” 
“CBO01C802BE35E600" 
“224D1833C802C802" 
“56CEFFFO66CCOC30" 
“60000172027 CD8FF" 
"“601470F14E753E33" 
“DEAEOO18508B0205" 
“4884D84491C890C4" 
*“4A34780067602074" 
“BA3COOO1663E47E8" 
“5D81B271ES8006422" 
“5CB12EOB598843FA" 
“PF2AQOLTAFF226E0058" 
"E24C600C58887802" 
“ 4E 406 00000CE64E40" 
“BASCOO0OO02670A720C" 
“280141FAFDE03478" 
“BO7AFDDO2204B288" 
“70184E414A806600" 
“FDB4347800DA4E92" 
», “OBS LOOOOESOI66F4" 
“FDO9SBBASCOOO3672A" 
“OO5B4A056A0C2447" 


“QOOO9E2Z4C5D4422165" 
“ZOCAS9BCO90076800" 


"| "6038BA3C000165C8" 


“. "“20CA548874109282" 


“B5B1ICCFFF8027CDSFF" 
“4554FDB005414C54" 
“#" 69093 
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REMark Simple User Heap scanner SNG v3.4 1/3/91 


x=RESPR(1024) : LBYTES "flpi_ALTER_CODE",x : CALL »x 

SET SENTINEL TO »+12 :REMark This MUST follow the LBYTES 
SET HEAP_START TO PEEK_L (SENTINEL) +SENTINEL~—16 

REMark The -16 ensures that SENTINEL is itself shown 
SHOW_HEAF : STOP 

DEFine FuNction FREE_HEAP 

REMark Returns size of the FIRST free space in the SET HEAP 
RETurn PEEK_L(PEEK_L (SENTINEL) +SENTINEL—4) 

END DEFine SHOW HEAP 


- 


DEFine PROCedure SHOW HEAP 


mo LOCal p,f,length 


REMark Shows used/free entries from the first SET heap block, 
REMark as long as you set up SENTINEL and HEAP_START as above. 
LET p=HEAP_START : LET #=SENTINEL 
REMark Skip over any extension blocks at lower addresses... 
REPeat seek: f=f+PEEK_L(#): IF PEEK_L(f)=0 OR f>=p: EXIT seek 
CSIZE 1,1 : PRINT “Heap address“ TO 153"Bytes" : CSIZE 1,0 
REPeat loop 

LET length=PEEK_L (p-4) 

PRINT " @ "3p-43 TO 143length!! 

IF p=f : PRINT “free” : f=f+PEER_Lif) 

IF PEEK _Lipi=0 : EXIT loop 

LET p=p + length 
END REPeat loop 
END DEFine SHOW_HEAP 


: ELSE PRINT *used’ 
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official way of doing things, but | have 
found it effective on a range of QLs and 
clones from Sinclair’s JM to Sigma FP, 
Minerva 1.64 and Argos 6.41. 

Bugs in AH and JM roms would make 
the name inaccessible to the current pro- 
gram if | followed the rules and tried to set 
it with BP.INIT. Once the Name Table 
entry is POKEd the new name works just 
like a Resident Function. 

The ALTER_ASM file outlines a method 
of calling BP. INIT from SET. This would 
allow compiled tasks to create Resident 
variables and constants, but could cause 
annoying mistakes. If you mistakenly SET 
a name that already has a value the code 
would create a new name, corresponding 
to the odd value. 

| decied that this ‘improvement’ was not 
worth the problems it might bring. In any 
case, inter-task communication is easy as 
long as you create Resident Variables with 
SET commands in your SuperBasic BOOT 
program or loader, before loading tasks. 
Once the name is known to the system any 
task can ALTER it or read the latest value. 

Text and programs based on this series 
are available on disk or cartridge. DIY 
Toolkit Volume U explores User Heaps 
and User-made Functions. Volume U con- 
tains the full assembler and binary code for 
SET and ALTER, routines that sift the | 
contents of the Common Heap and SET | 
User Heaps, plus extra documentation 
and scores of useful constants and vectors. 

The 15 Volumes of DIY Toolkit cost £3 
each, plus a processing fee of £4 per 
order. This covers first class or air mail 
delivery and 3.5 or 5.25 inch disk media; 
microdrive cartridge orders must come 
with one formatted cartridge for each vol- 
ume required. To obtain DIY files, or a 
catalogue, ring Richard Alexander on 
(0559) 384574, or write to DIY Toolkit, 
Cwm Gwen Hall, Pencader, Dyfed, 
Cymru SA39 SHA. 


Since 1987 DIY Toolkit has illustrated 
Qdos programming from concepts to test- 
ing, with short, interesting examples that 
fillthe gaps in existing Toolkits. lenjoy your 
letters and am always on the lookout for 
new keywords or topics of interest to read- 
ers. Please send your requests to the QL 
World editorial address. 
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